Contribute
Help us make this useful to the next PM.
The repo is MIT. The site is open source. We curate, we don’t gatekeep — a drive-by PR is welcome.
What we accept
- New skills. One
SKILL.mdper PR, using the seven-section format the six starter skills follow. Add an attribution footer. Editsite/src/content/skills.jsonto surface it on /skills. - Better practice pages. If a practice MDX file in
site/src/content/best-practices/is wrong, outdated, or missing context, file an issue or send a PR. Cite a public source. - Template improvements. If
templates/CLAUDE.mdor any of thepr_flow/rules would be clearer with one more section, propose it. - Fixes & improvements. Broken links, typos, tightened copy, a11y fixes. Small ones get merged fast.
- Translations. English-only in V1. If you want to translate, open an issue first so we can plan routing.
What we don’t accept
- Marketing for your product. We have nothing against you — just keep it out of the playbook.
- Unverified claims or anything you can’t link to a public source.
- Skills that re-package a tool’s manual. Skills encode judgment.
- Skills that require a paid service to install.
- Anything that turns this into a course or gated content.
- Breaking changes to the template file paths. Other tools depend on them.
How to open a PR
- Fork runtm-ai/claudecode-for-pms.
- Branch off
main. Keep the change small. - Run the site locally to check formatting:
git clone https://github.com/runtm-ai/claudecode-for-pms.git
cd claudecode-for-pms/site
npm install
npm run dev # http://localhost:3000- For a new skill, name the PR
add: skills/<name>. - For a new practice, name it
add: best-practices/<slug>. - Open the PR with a 2-3 sentence description (what + why). We respond within a week.
Secrets
Never commit a real API key. The repo ships with .gitleaks.toml — wire it as a pre-commit hook before your first commit. Use .env.local (gitignored) and ${VAR} substitution in .mcp.json. The full playbook is in practice 07, including how we burned ourselves on day zero.
Voice
- Plainspoken, declarative, period-ending sentences.
- No buzzwords. Banned-words list lives in
templates/CLAUDE.md. - Active verbs, specific nouns.
Code of conduct
We follow the Contributor Covenant. Be kind, assume good faith, leave the playbook better than you found it. The reviewer is volunteering their afternoon — disagreements get resolved on the issue thread, not in comments on the diff.
Get started
Clone the repo. Open it in Claude Code.
Two minutes from clone to your first PRD. Fill in three files and ship.
git clone https://github.com/runtm-ai/claudecode-for-pms.gitMIT licensed. Star the repo if it saves you an afternoon.