# Mkdocs Code Annotations

> Sub-skill of mkdocs: Code Annotations.

- Skill: `vamseeachanta/mkdocs-code-annotations` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/mkdocs-code-annotations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/mkdocs-code-annotations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/mkdocs-code-annotations

---


# 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^2