mkdocs-code-annotations
Sub-skill of mkdocs: Code Annotations.
Best use case
mkdocs-code-annotations is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Sub-skill of mkdocs: Code Annotations.
Teams using mkdocs-code-annotations should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/code-annotations/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How mkdocs-code-annotations Compares
| Feature / Agent | mkdocs-code-annotations | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Sub-skill of mkdocs: Code Annotations.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Code Annotations
## Code Annotations
```python
def calculate_area(radius: float) -> float: # (1)!
"""Calculate the area of a circle."""
import math # (2)!
return math.pi * radius ** 2 # (3)!
```
1. Type hints improve code readability
2. Import inside function for demonstration
3. Uses the formula: A = pi * r^2Related Skills
mkdocs-with-title
Sub-skill of mkdocs: With Title.
mkdocs-warning
MkDocs warning admonition syntax. Use when alerting readers to potential issues or cautions in MkDocs documentation.
mkdocs-tip
MkDocs tip admonition syntax. Use when adding best-practice suggestions or pro tips to MkDocs documentation.
mkdocs-tabbed-code-blocks
Sub-skill of mkdocs: Tabbed Code Blocks.
mkdocs-success
MkDocs success admonition syntax. Use when indicating completed actions or successful outcomes in MkDocs documentation.
mkdocs-subsection-11
Sub-skill of mkdocs: Subsection 1.1.
mkdocs-state-diagram
Sub-skill of mkdocs: State Diagram.
mkdocs-sequence-diagram
Sub-skill of mkdocs: Sequence Diagram.
mkdocs-section-2
Sub-skill of mkdocs: Section 2.
mkdocs-quote
MkDocs quote admonition syntax. Use when embedding notable quotations or citations in MkDocs documentation.
mkdocs-note
MkDocs note admonition syntax. Use when highlighting important information readers should pay attention to in MkDocs documentation.
mkdocs-line-numbers
Sub-skill of mkdocs: Line Numbers.