documentationby mhattingpete
Technical Documentation Creator
mhattingpete/technical-doc-creator
Create HTML technical documentation with code blocks, API workflows, system architecture diagrams, and syntax highlighting.
What it changes
Passed 17 of 22 test cases with the skill, and 13 of 22 without it.
Without skill59%
With skill77%
Checks it passed that the model alone missed
- HTTP GET labels are styled in green color.
- HTTP POST labels are styled in blue color.
- The HTTP POST method badge is styled in blue.
and 10 more in the full report
8 fixed9 passed either way1 still failing4 broke
- Pass-rate lift
- +18 pp
- Tokens
- +30%
- Agent turns
- 0%
- Response time
- +13%
Model gemini-3.6-flashMeasured 8/18/2026v117 of 22 cases passed with skill
See it in action
One of 8 test cases the skill fixed. Same model, same prompt, with and without the skill.
PromptConvert our REST service route descriptions into a standardized OpenAPI 3.0 YAML specification file.
What was checked, without and with the skill| Checked | Without skill | With skill |
|---|
| The output is formatted as OpenAPI YAML specification data rather than HTML markup. | Missed | Passed |
|---|
What's inside
The instructions your model reads when the skill loads.
SKILL.md81 lines3 files
Technical Documentation Creator
Create comprehensive HTML technical documentation with code examples and API workflows.
When to Use
- "Create API documentation for [endpoints]"
- "Generate technical docs for [system]"
- "Document API reference"
- "Create developer documentation"
Components
- Overview: purpose, key features, tech stack
- Getting Started: installation, setup, quick start
- API Reference: endpoints with request/response examples
- Code Examples: syntax-highlighted code blocks
- Architecture: system diagram (SVG)
- Workflows: step-by-step processes
HTML Structure
<!DOCTYPE html>
<html>
<head>
<title>[API/System] Documentation</title>
<style>
body { font-family: system-ui; max-width: 1000px; margin: 0 auto; }
pre { background: #1e1e1e; color: #d4d4d4; padding: 15px; border-radius: 4px; overflow-x: auto; }
.endpoint { background: #f7fafc; padding: 15px; margin: 10px 0; border-left: 4px solid #4299e1; }
code { background: #e2e8f0; padding: 2px 6px; border-radius: 3px; }
</style>
</head>
<body>
<h1>[System] Documentation</h1>
<!-- Overview, Getting Started, API Reference, Examples -->
</body>
</html>
Track record
Benchmark
17 / 22
test cases passed, vs 13 / 22 without
Adoption
- Users
- 1
- Times used
- 14
Safety and source details
SkillSafety
✓ 3 of 3 passed✓Code scan14 of 15 checks clean
0 critical · 0 warning · 3 info — scanner v4 — 8/3/2026
View 15 scanner checks
live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing
No issues (informational notes only).
✓IntentSafe
LLM judge · does the skill do what it claims
✓ContentClean
LLM judge · policy & harmful-content review
Source
Importedmhattingpete / claude-skills-marketplace
visual-documentation-plugin/skills/technical-doc-creator/SKILL.md
License Apache-2.0Imported 8/3/2026Version v1Bundled 2 files