Screened · automated checks passed

describe-design

from posit-dev/skills · ★ 431 on GitHub · found by our crawler 2026-07-07

What the author says it does

Research a codebase and create architectural documentation describing how features or systems work. Use when the user asks to: (1) Document how a feature works, (2) Create an architecture overview, (3) Explain code structure for onboarding or knowledge transfer, (4) Research and describe a system's design. Produces markdown documents with Mermaid diagrams and stable code references suitable for humans and AI agents.

Quoted from the skill's own SKILL.md trigger description — this is what tells Claude when to activate it. Not yet verified by us.

Automated screening

100/100 validator score

Scored by the same rules as our free SKILL.md validator: trigger description quality, body substance, structure. Automated — a human bench test is the next step in the pipeline.

Install (unverified — review first)

git clone https://github.com/posit-dev/skills
# skill lives at: posit-dev/describe-design/SKILL.md

SkillProof status

This skill is in our test queue. We install every skill in a clean environment, run a trigger battery and score output against a baseline before it earns a catalog page — the full protocol is public. Until then, treat it like any unreviewed dependency: read the SKILL.md and any scripts before installing.

Already tested in Documents & Files

  • TR Dizin ★ 10.0/10 Stdlib-only CLI for the open TR Dizin (Turkish national academic index) JSON API — search, filters, PDF-to-text
  • Patent Writing Chinese ★ 10.0/10 Generates CNIPA-style Chinese patent .docx files with real OMML equations and B&W block diagrams.
  • DOCX — Word Documents ★ 9.6/10 Create and edit real Word documents — headings, tables, tracked changes.
  • Shipping Artifacts ★ 9.6/10 Defines the doc set that makes an AI-built app reviewable before it ships.

Top 10 Documents skills, ranked →