Thanks for your interest! Here's how to contribute.
Found a diagnostic that gives wrong results? Open an issue.
Have an idea for a new diagnostic? Open a feature request. Include:
- What the diagnostic measures
- Why it matters
- Example of what it would catch
code-autopsy works best with TypeScript/JavaScript. PRs that improve detection patterns for Python, Rust, Go, Java, or other languages are welcome.
The HTML report is the product. If you can make it look better, more informative, or more accessible — that's a high-value contribution.
Run code-autopsy on an open-source project and contribute the report as an example. Include the project name, what was found, and what the maintainers said.
- Fork the repo
- Create a branch:
git checkout -b feat/my-change - Make your changes
- Test by running the skill on a real codebase
- Submit a PR with a clear description of what changed and why
- SKILL.md is the source of truth — keep it concise, quantified, and actionable
- HTML reports must be self-contained (no external dependencies)
- Every diagnostic must produce a number (score), not just text
- Prioritize precision over recall — no false positives
Be constructive. We're here to make codebases healthier, not to gatekeep or judge.