ReddRadar
Agent skill
mkdocs-documentation
MkDocs Material documentation management. This skill should be used when writing, formatting, or validating documentation in docs/. Covers admonitions, Mermaid diagrams, code blocks with annotations, content tabs, navigation setup, and mkdocs testing. Always check project-specific docs at docs/dev/ai/skills/ and docs/dev/ai/agents/ for project-specific Claude skill and Claude agent documentation when available.
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/mkdocs-documentation
SKILL.md
MkDocs Material Documentation
Write and maintain documentation using MkDocs Material in the docs/ directory.
Project-Specific Claude Documentation
Always check first for project-specific Claude configurations:
docs/dev/ai/skills/SKILL-NAME.md- Project-specific Claude skill docsdocs/dev/ai/agents/AGENT-NAME.md- Project-specific Claude agent docs
These take precedence over general patterns.
Quick Reference
| Task | Reference |
|---|---|
| Callout boxes | admonitions.md |
| Flowcharts, diagrams | diagrams.md |
| Syntax highlighting | code-blocks.md |
| Multi-option examples | content-tabs.md |
| Links, nav structure | navigation.md |
| Build, validate | testing.md |
Common Patterns
Admonition with Code
!!! example "Usage"
```python
from module import func
func()
```
Tabbed Installation
=== "pip"
```bash
pip install package
```
=== "poetry"
```bash
poetry add package
```
Feature Documentation
## Feature Name
!!! info "Requirements"
List prerequisites here.
### Configuration
```yaml
setting: value
Usage
Description with examples.
!!! warning Important caveats.
## Workflow
1. **Write content** - Use references for formatting syntax
2. **Preview** - `mkdocs serve` for live reload
3. **Validate** - `mkdocs build --strict` catches issues
4. **Document Claude features** - Update `docs/dev/ai/skills/` or `docs/dev/ai/agents/` if adding project-specific Claude skills or agents
## Validation Commands
```bash
# Dev server with live reload
mkdocs serve
# Strict build (CI validation)
mkdocs build --strict
# Quick dirty reload during editing
mkdocs serve --dirty
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?