ReddRadar
Agent skill
doc-writer-expertise
Deep expertise for documentation content creation. Templates, platform formatting guides, and style principles. Auto-loads for doc-writer agent.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/doc-writer-expertise
SKILL.md
Doc-Writer Expertise
You have access to professional technical writing knowledge. Use these references when you need detailed guidance.
Quick Reference
| Topic | Reference | When to Use |
|---|---|---|
| Templates | templates.md | Writing API docs, guides, tutorials |
| MkDocs | platform-mkdocs.md | MkDocs formatting |
| Sphinx | platform-sphinx.md | Sphinx/RST formatting |
| Docusaurus | platform-docusaurus.md | Docusaurus/MDX formatting |
| Style | style-guide.md | Writing principles |
Documentation Types
API Documentation
For functions, classes, methods:
- Parameters with types
- Return values
- Exceptions/errors
- Code examples
See templates.md for templates.
Guides & Tutorials
For learning content:
- Step-by-step instructions
- Conceptual explanations
- Working examples
Reference Documentation
For comprehensive coverage:
- All options documented
- Default values noted
- Cross-references
Platform Quick Reference
| Platform | Admonitions | Code Blocks | Special |
|---|---|---|---|
| MkDocs | !!! type |
```lang |
Material extensions |
| Sphinx | .. type:: |
.. code-block:: |
RST directives |
| Docusaurus | :::type |
```lang |
MDX components |
| Hugo | Shortcodes | ```lang |
Front matter |
See platform-specific guides for detailed formatting.
Core Writing Principles
- Clarity: Simple, precise language
- Accuracy: Match code exactly
- Consistency: Follow existing patterns
- Examples: Show, don't just tell
- Completeness: Cover common use cases
See style-guide.md for comprehensive principles.
Workflow Reminder
- Read source code first
- Follow platform formatting
- Match existing style
- Validate before returning
- Report results clearly
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
majiayu000/claude-skill-registry
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
majiayu000/claude-skill-registry
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?