skill

documentation-and-adrs

Records decisions and documentation. Use when making architectural decisions, changing public APIs, shipping features, or when you need to record context that future engineers and agents will need to understand the codebase.

Description as published by the maintainer. Source

• active

active — Most recent push to the repository was 2026-08-05.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Will this work with your setup?

No harness stated by the author and no install path convention detected. Compatibility is untested.

We have not run this skill against a task with and without it enabled, so we cannot tell you whether it improves anything, what it costs in tokens, or whether it duplicates behaviour your harness already has. When we have run that test, the result will appear on this page with the task, the versions and the budget it used.

The skill definition lives at skills/documentation-and-adrs/SKILL.md in https://github.com/addyosmani/agent-skills.

Where to get it

• Repository — https://github.com/addyosmani/agent-skills

Related, by what their authors tagged them

• addyosmani-agent-skills-api-and-interface-design — last commit 2026-08-05, shares antigravity
  Guides stable API and interface design. Use when designing APIs, module boundaries, or any public interface. Use when c…
• addyosmani-agent-skills-browser-testing-with-devtools — last commit 2026-08-05, shares antigravity
  Tests in real browsers via Chrome DevTools MCP. Use when building or debugging anything that runs in a browser. Use whe…
• addyosmani-agent-skills-ci-cd-and-automation — last commit 2026-08-05, shares antigravity
  Automates CI/CD pipeline setup. Use when setting up or modifying build and deployment pipelines. Use when you need to a…
• addyosmani-agent-skills-code-review-and-quality — last commit 2026-08-05, shares antigravity
  Conducts multi-axis code review. Use before merging any change. Use when reviewing code written by yourself, another ag…
• addyosmani-agent-skills-code-simplification — last commit 2026-08-05, shares antigravity
  Simplifies code for clarity. Use when refactoring code for clarity without changing behavior. Use when code works but i…
• addyosmani-agent-skills-context-engineering — last commit 2026-08-05, shares antigravity
  Optimizes agent context setup. Use when starting a new session, when agent output quality degrades, when switching betw…
• addyosmani-agent-skills-debugging-and-error-recovery — last commit 2026-08-05, shares antigravity
  Guides systematic root-cause debugging. Use when tests fail, builds break, behavior doesn't match expectations, or you…
• addyosmani-agent-skills-deprecation-and-migration — last commit 2026-08-05, shares antigravity
  Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one…
• addyosmani-agent-skills-doubt-driven-development — last commit 2026-08-05, shares antigravity
  Subjects every non-trivial decision to a fresh-context adversarial review before it stands. Use when correctness matter…
• addyosmani-agent-skills-frontend-ui-engineering — last commit 2026-08-05, shares antigravity
  Builds production-quality, accessible, responsive user-facing UIs. Use when building or modifying interfaces and pages,…

These share tags the maintainers applied themselves, such as antigravity. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.

This is not a recommendation and not a test result. It is a map of what the authors said their work is about.

Also from addyosmani

• addyosmani-agent-skills-git-workflow-and-versioning — last commit 2026-08-05
  Structures git workflow practices. Use when making any code change. Use when committing, branching, resolving conflicts…
• addyosmani-agent-skills-idea-refine — last commit 2026-08-05
  Refines raw ideas into sharp, actionable concepts through structured divergent and convergent thinking. Use when an ide…
• addyosmani-agent-skills-incremental-implementation — last commit 2026-08-05
  Delivers changes incrementally. Use when implementing any feature or change that touches more than one file. Use when y…
• addyosmani-agent-skills-interview-me — last commit 2026-08-05
  Extracts what the user actually wants instead of what they think they should want. Achieves this through one-question-a…
• addyosmani-agent-skills-observability-and-instrumentation — last commit 2026-08-05
  Instruments code so production behavior is visible and diagnosable. Use when adding logging, metrics, tracing, or alert…
• addyosmani-agent-skills-performance-optimization — last commit 2026-08-05
  Optimizes application performance across frontend, backend, queries, and databases. Use when performance requirements e…
• addyosmani-agent-skills-planning-and-task-breakdown — last commit 2026-08-05
  Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementabl…
• addyosmani-agent-skills-security-and-hardening — last commit 2026-08-05
  Hardens code against vulnerabilities. Use when handling user input, authentication, data storage, or external integrati…
• addyosmani-agent-skills-shipping-and-launch — last commit 2026-08-05
  Prepares production launches. Use when preparing to deploy to production. Use when you need a pre-launch checklist, whe…
• addyosmani-agent-skills-source-driven-development — last commit 2026-08-05
  Grounds every implementation decision in official documentation. Use when you want authoritative, source-cited code fre…

How the author describes it

Topics the maintainer set on GitHub: agent-skills, antigravity, claude-code, codex, cursor, skills.