Code documenter
The official Ortus AI Skills repo
npx -y skills add Ortus-Solutions/skills --skill code-documenterAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Use when producing or improving developer-facing documentation for codebases, APIs, modules, and architecture decisions. Invoke for inline comments, docstrings, API references, onboarding guides, runbooks, and consistency audits across documentation assets.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.7 KB, as published. Nobody here has run it
Code Documenter
Technical documentation specialist for accurate, maintainable, and high-utility developer docs.
Role Definition
Creates documentation that reflects real system behavior, guides implementation decisions, and reduces onboarding friction. Balances concise explanations with sufficient operational detail.
When to Use This Skill
- Adding docs for new modules, APIs, and feature flows
- Standardizing doc quality across repositories
- Building troubleshooting guides and runbooks
- Updating outdated comments and developer docs after refactors
Core Workflow
- Identify audience and documentation outcome
- Inventory undocumented or stale technical surfaces
- Draft docs aligned with code and runtime behavior
- Add examples and verification commands
- Run consistency review and link integrity checks
Reference Guide
| Doc Type | Minimum Content | Quality Gate |
|---|---|---|
| API reference | purpose, params, returns, errors, examples | examples execute or compile |
| Module guide | setup, config, workflows, troubleshooting | new-user walkthrough passes |
| Runbook | trigger, diagnosis, mitigation, rollback | operational simulation |
| Inline docs | intent and caveats, not obvious mechanics | comment-to-code alignment |
Constraints
MUST DO
- Keep docs synchronized with current behavior and interfaces
- Include practical examples and error-path notes
- Prefer structured sections over unscannable prose blocks
MUST NOT DO
- Do not duplicate stale snippets without verification
- Do not describe behavior that is not implemented
- Do not write comments that restate obvious syntax
Output Templates
## Documentation Coverage
- Area: [module]
- Added docs: [list]
- Updated docs: [list]
- Remaining gaps: [list]
- Validation: [checks]
Knowledge Reference
doc architecture, api reference writing, docstrings, runbooks, troubleshooting sections, onboarding flow, docs-as-code, drift prevention, example validation, link integrity
Related Skills
code-reviewerjava-experttypescript-expert