code-documenter

Use when adding docstrings, creating API documentation, or building documentation sites. Invoke for OpenAPI/Swagger specs, JSDoc, doc portals, tutorials, user guides.

Install with Tessl CLI

npx tessl i github:jeffallan/claude-skills --skill code-documenter

What are skills?

Review — 64%

Does it follow best practices?

If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:

npx tessl skill review --optimize ./path/to/skill

Learn more

Evaluation — 94%

Agent success when using this skill

Validation — 11 / 11 Passed

Validation for skill structure

SKILL.md

Review

Evals

Evaluation results

100%

11%

Document a FastAPI Payment Processing Service

Python FastAPI docstrings and coverage report

Criteria

Without context

With context

Google-style Args block

100%

Google-style Returns block

100%

Raises block present

100%

FastAPI summary param

100%

FastAPI tags param

100%

FastAPI response_model

100%

Pydantic Field with example

100%

Class Attributes section

100%

Coverage report generated

100%

Before/After coverage stats

50%

100%

Files modified table

25%

100%

Without context: $0.4045 · 2m 10s · 11 turns · 11 in / 8,297 out tokens

With context: $0.6214 · 2m 48s · 20 turns · 1,660 in / 10,216 out tokens

100%

Document a NestJS Order Management API

NestJS TypeScript JSDoc and Swagger decorators

Criteria

Without context

With context

JSDoc @param tags

100%

JSDoc @returns tags

100%

JSDoc @throws tags

87%

100%

JSDoc @example blocks

100%

@ApiTags on controllers

100%

@ApiOperation on endpoints

100%

@ApiResponse for success

100%

@ApiResponse for errors

100%

@ApiProperty on DTOs

90%

100%

@ApiPropertyOptional for optional

100%

@ApiBearerAuth decorator

100%

Coverage report generated

100%

Without context: $0.4071 · 1m 44s · 14 turns · 63 in / 7,332 out tokens

With context: $0.8612 · 2m 49s · 30 turns · 1,462 in / 11,319 out tokens

84%

25%

Build a Documentation Site for a Python Data Validation SDK

MkDocs site with user guides and troubleshooting

Criteria

Without context

With context

MkDocs chosen

100%

Material theme configured

100%

Material theme features

100%

mkdocstrings plugin

Nav structure configured

100%

Quick start prerequisites

100%

Quick start verify step

100%

Tutorial with checkpoints

30%

100%

Troubleshooting format

100%

Mermaid diagram included

100%

Progressive disclosure in auth/config

FAQ section present

100%

Without context: $0.9272 · 4m 21s · 26 turns · 26 in / 17,639 out tokens

With context: $1.3500 · 5m 37s · 35 turns · 32 in / 21,658 out tokens

Evaluated: about 6 hours ago
Agent: Claude Code

Table of Contents

Document a FastAPI Payment Processing Service Document a NestJS Order Management API Build a Documentation Site for a Python Data Validation SDK

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.