Skip to main content
Back to the directory
addyosmani/agent-skillsSoftware EngineeringFrontend and Design

documentation-and-adrs

Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision. Code shows what was built; documentation explains why it was built this way and what alternatives were considered . This context is essential for future humans and...

SkillJury keeps community verdicts, source metadata, and external repository signals in separate lanes so ranking data never pretends to be a review.

SkillJury verdict
Pending

No approved reviews yet

Would recommend
Pending

Waiting on enough review volume

Install signal
1

Weekly or total install activity from catalog data

Sign in to review
0 review requests
Install command
npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs
SkillJury does not have enough approved reviews to publish a community verdict yet. Source metadata and repository proof are still available above.
SkillJury Signal Summary

As of Apr 30, 2026, documentation-and-adrs has 1 weekly installs, 0 community reviews on SkillJury. Community votes currently stand at 0 upvotes and 0 downvotes. Source: addyosmani/agent-skills. Canonical URL: https://skills.sh/addyosmani/agent-skills/documentation-and-adrs.

Security audits
Gen Agent Trust HubPASS
SocketPASS
SnykPASS
About this skill
Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision. Code shows what was built; documentation explains why it was built this way and what alternatives were considered . This context is essential for future humans and agents working in the codebase. When NOT to use: Don't document obvious code. Don't add comments that restate what the code already says. Don't write docs for throwaway prototypes. ADRs capture the reasoning behind significant technical decisions.

Source description provided by the upstream listing. Community review signal and install context stay separate from this narrative layer.

Community reviews

Latest reviews

No community reviews yet. Be the first to review.

Browse this skill in context
FAQ
What does documentation-and-adrs do?

Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision. Code shows what was built; documentation explains why it was built this way and what alternatives were considered . This context is essential for future humans and...

Is documentation-and-adrs good?

documentation-and-adrs does not have approved reviews yet, so SkillJury cannot publish a community verdict.

Which AI agents support documentation-and-adrs?

documentation-and-adrs currently lists compatibility with Claude Code, Skills CLI.

Is documentation-and-adrs safe to install?

documentation-and-adrs has been scanned by security audit providers tracked on SkillJury. Check the security audits section on this page for detailed results from Socket.dev and Snyk.

What are alternatives to documentation-and-adrs?

Skills in the same category include grimoire-morpho-blue, conversation-memory, second-brain-ingest, zai-tts.

How do I install documentation-and-adrs?

Run the following command to install documentation-and-adrs: npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs

Related skills

More from addyosmani/agent-skills

addyosmani/agent-skills/Software Engineering

code-review-and-quality

Multi-dimensional code review with quality gates. Every change gets reviewed before merge — no exceptions. Review covers five axes: correctness, readability, architecture, security, and performance.

Weekly installs
2
Community vote
0
0 up / 0 down
Freshness
Synced Apr 30, 2026
Software EngineeringFrontend and DesignNo reviews yetSource addyosmani/agent-skills
addyosmani/agent-skills/Software Engineering

frontend-ui-engineering

Build production-quality user interfaces that are accessible, performant, and visually polished. The goal is UI that looks like it was built by a design-aware engineer at a top company — not like it was generated by an AI. This means real design system adherence, proper accessibility, thoughtful interaction patterns,...

Weekly installs
2
Community vote
0
0 up / 0 down
Freshness
Synced Apr 30, 2026
Software EngineeringFrontend and DesignNo reviews yetSource addyosmani/agent-skills
addyosmani/agent-skills/Software Engineering

planning-and-task-breakdown

Decompose work into small, verifiable tasks with explicit acceptance criteria. Good task breakdown is the difference between an agent that completes work reliably and one that produces a tangled mess. Every task should be small enough to implement, test, and verify in a single focused session.

Weekly installs
2
Community vote
0
0 up / 0 down
Freshness
Synced Apr 30, 2026
Software EngineeringFrontend and DesignNo reviews yetSource addyosmani/agent-skills
addyosmani/agent-skills/Software Engineering

spec-driven-development

Write a structured specification before writing any code. The spec is the shared source of truth between you and the human engineer — it defines what we're building, why, and how we'll know it's done. Code without a spec is guessing.

Weekly installs
2
Community vote
0
0 up / 0 down
Freshness
Synced Apr 30, 2026
Software EngineeringFrontend and DesignNo reviews yetSource addyosmani/agent-skills
Related skills

Alternatives in Software Engineering