How to contribute

.gitignore

@@ -0,0 +1,2 @@
+_Internal/
+CLAUDE.md

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+PM Skills Marketplace is maintained by [Paweł Huryn](https://www.productcompass.pm) (pawel@productcompass.pm). Contributions are welcome — whether it's a bug fix, a typo, or a new skill idea.
+
+## How to Contribute
+
+- **Bugs and small fixes** — open a PR directly.
+- **New skills, commands, or larger changes** — open an issue first so we can discuss the approach.
+
+## Guidelines
+
+- Keep PRs focused — one change per PR.
+- Follow existing patterns: skills are nouns (domain knowledge), commands are verbs (workflows).
+- Every skill needs frontmatter with `name` and `description`. Every command needs `description` and `argument-hint`.
+- Skill `name` must match its directory name.
+- No cross-plugin references in commands. Suggest follow-ups in natural language only.
+- Every contributor will be listed publicly.
+- Run the validator before submitting: `python3 validate_plugins.py`
+
+## License
+
+By contributing, you agree that your contributions will be licensed under the [MIT License](LICENSE).

README.md

@@ -389,6 +389,10 @@ Selected skills based on the work of:
 
 Curated by Paweł Huryn from [The Product Compass Newsletter](https://www.productcompass.pm).
 
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
 ## Known Issue on Windows
 
 If your Cowork is unstable and can't start a VM ([claude-code/issues/27010](https://github.com/anthropics/claude-code/issues/27010)), try: