Dev & Engineering

Source-Driven Development

Ground framework and library decisions in current official documentation instead of stale memory.

51/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 107k
Last updated
13d ago
License
MIT
official-documentationframework-verificationsource-citationversion-awareness
+1api-correctness

What does this skill do, and when should you use it?

Source-Driven Development is one standalone skill in the addyosmani/agent-skills repository, focused on version-sensitive framework and library work. It instructs an agent to identify dependency versions, retrieve the relevant official documentation, implement documented patterns, and cite the sources. It also requires explicit disclosure when a pattern cannot be verified and requires conflicts between documentation and existing code to be surfaced. It is a good fit for correctness-focused engineering work, but not for tasks where speed is explicitly more important than verification.

Instructs the agent to read dependency files such as package.json, composer.json, requirements.txt, pyproject.toml, go.mod, Cargo.toml, and Gemfile; identify framework and library versions; fetch the specific official documentation for the feature being implemented; follow documented API signatures, recommendations, and migration guidance; provide full-URL citations for framework-specific decisions; flag unverified patterns; and report conflicts between official documentation and existing project code.

Good fit
  • A frontend developer building forms, routing, or data fetching against a specific React, Vue, Angular, or Svelte version needs to avoid outdated APIs.
  • A backend developer implementing Django, Flask, Laravel, or Symfony behavior needs to confirm the current version's documented approach.
  • A team creating starter code or reusable framework patterns wants each implementation decision to be traceable to an authoritative source.
  • A maintainer reviewing framework-specific code needs to check deprecations and migration guidance before changing it.
  • A user explicitly requests documented, verified, or current-best-practice implementation rather than code based on memory.

How do you install this skill?

Before you use it
  • This assessment is source-only; the workflow, documentation fetching, or generated code was not executed or independently tested.
  • Users should confirm dependency versions, access to cited official documentation, and alignment between documentation and the project version.
  • Official citations do not prove that the resulting code works; project tests, compatibility checks, and security review remain necessary.
Before you start
Your agent needs
  • Network access
  • Local filesystem

Install this individual skill with the skills CLI:

npx skills add addyosmani/agent-skills --skill source-driven-development

The repository also supports installing the complete 24-skill collection:

npx skills add addyosmani/agent-skills

The README does not document a universal installation directory for this individual skill across every agent.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/addyosmani/agent-skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/source-driven-development" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Trigger it when implementing or reviewing version-sensitive framework or library code. Example prompt:

Use source-driven-development: inspect the project's dependency versions, find the official documentation for the relevant version and feature, implement the documented pattern, and cite every framework-specific decision with a full URL.

Do not use it for version-independent edits such as renaming variables or fixing typos, or when the user explicitly prioritizes speed over verification.

What are this skill's strengths and limitations?

Pros
  • Requires dependency-version detection before implementation.
  • Makes framework-specific decisions auditable through official full-URL citations.
  • Explicitly addresses deprecations, migration guidance, documentation conflicts, and unverified patterns.
  • Provides a clear DETECT, FETCH, IMPLEMENT, CITE workflow plus verification criteria.
Limitations
  • Depends on access to the project's dependency files and relevant official documentation.
  • Does not include framework-specific documentation, test scripts, or automation tooling.
  • Adds documentation lookup and citation overhead to implementation work.
  • Is intentionally unsuitable when the user explicitly values speed over verification or when version-specific correctness is irrelevant.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Source-Driven Development this page 51 · Use with care ★ 107k 13d ago MIT
Effect JSDoc Authoring Skill 77 · Strongly recommended ★ 28k 12d ago MIT
OpenAI Developer Docs Assistant ✓ OpenAI · Official 55 · Use with care ★ 28k 4mo ago —
step.parts Catalog Skill 55 · Use with care ★ 20k 15d ago MIT
NVIDIA DOCA Public Knowledge Map ✓ NVIDIA · Official 54 · Use with care ★ 3.6k 12d ago Apache-2.0

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
51/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust16 / 25 · 3.2/5

The skill requires official documentation, explicit version detection, and visible citations; it also asks the user to choose when documentation conflicts with existing code. It does not specify sensitive-data handling, permission boundaries, external-request data flows, rollback, or dependency security, so points are deducted.

2Reliability8 / 20 · 2.0/5

The DETECT→FETCH→IMPLEMENT→CITE workflow is internally coherent and addresses missing versions, documentation conflicts, and unverifiable patterns. It provides no executable scripts, abnormal-input tests, or detailed failure feedback, and static review cannot reproduce key paths, so the score is limited to 8.

3Adaptability9 / 15 · 3.0/5

Trigger and non-trigger scenarios are reasonably clear for framework-specific implementation, review, and version-sensitive correctness. The scope is broad, with no explicit Chinese-language or mainland-China reachability guidance; the core workflow depends on online official documentation, so points are deducted.

4Convention8 / 15 · 2.7/5

The skill has clear overview, trigger, process, rationalization, red-flag, and verification sections; repository context supplies MIT licensing, named maintainers, and CI. The skill itself lacks versioning, changelog, installation notes, explicit maintenance ownership, and troubleshooting guidance, so points are deducted.

5Effectiveness6 / 15 · 2.0/5

For tasks requiring current framework patterns and auditable citations, the workflow can improve transparency and reduce obsolete API usage. There are no representative outputs, runtime verification, or comparative cost-benefit evidence, and results still require user review; under static calibration it receives 6.

6Verifiability4 / 10 · 2.0/5

The skill defines an official-source hierarchy, deep-link citation rules, and explicit unverified notices, providing some auditability. The supplied CI validates repository structure and general evaluations but does not demonstrate coverage of this skill's key paths or independent corroboration, so points are deducted.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019 Review evidence[1][2][3][4][5]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Is this skill limited to one framework?
No. It applies to any framework or library where version-specific correctness matters, provided the agent can identify the version and consult authoritative documentation.
Does it automatically run tests?
The SKILL.md does not prescribe test commands. Its defined work covers version detection, documentation verification, implementation guidance, citations, and verification disclosures.
What happens when official documentation does not cover a pattern?
The pattern should be explicitly marked as unverified rather than presented as authoritative.
When should I avoid using it?
Avoid it for version-independent edits or when the user explicitly asks for speed over verification.

More skills from this repository

All from addyosmani/agent-skills

Dev & Engineering

Architecture Decisions & Docs

Preserve engineering context by documenting decisions, APIs, and the reasons behind them.

★ 107k FS 53 Use with care 13d ago
Dev & Engineering

Planning & Task Breakdown

Turn clear requirements into ordered, implementable, and verifiable engineering tasks.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Doubt-Driven Development

Challenge non-trivial decisions with a fresh adversarial review before they stand.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Incremental Implementation

Deliver multi-file engineering changes through small, tested, reversible slices.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Stable Interface Design

A practical guide to designing stable, clear, and hard-to-misuse APIs and module interfaces.

★ 107k FS 50 Use with care 13d ago
Dev & Engineering

Context Engineering

Helps coding agents load the right project context at the right time, reducing guesswork and convention drift.

★ 107k FS 49 Use with care 13d ago
Dev & Engineering

Engineering Workflow Navigator

Find and invoke the right engineering workflow skill for each task phase.

★ 107k FS 46 Use with care 13d ago
Dev & Engineering

Browser DevTools Testing

Validate and debug web applications with real-browser runtime evidence.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Intent Interviewer

Clarify the real problem through one-question-at-a-time interviews before planning or coding.

★ 107k FS 59 Recommended 13d ago
Dev & Engineering

Test-Driven Development Workflow

Prove intended behavior with a failing test before implementing, refactoring, and verifying the change.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Code Clarity Refactor

Reduce code complexity while preserving exact behavior, so teammates can read, modify, and debug it faster.

★ 107k FS 57 Use with care 13d ago
Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

★ 107k FS 55 Use with care 13d ago
Dev & Engineering

Git Workflow & Release Discipline

Keep AI-generated changes reviewable, reversible, and ready to release.

★ 107k FS 54 Use with care 13d ago
Dev & Engineering

Performance Optimization Engineering Skill

Measure, diagnose, and verify fixes for frontend, backend, query, and database performance bottlenecks.

★ 107k FS 54 Use with care 13d ago
Design & Frontend

Production Frontend UI Engineering

Guides AI coding agents to build accessible, responsive, design-system-aligned production interfaces.

★ 107k FS 53 Use with care 13d ago
Automation & Ops

Production Observability

Make production behavior visible and diagnosable with structured logs, metrics, traces, and actionable alerts.

★ 107k FS 53 Use with care 13d ago
Automation & Ops

Security Hardening Engineering Skill

Gives coding agents a structured defense workflow for untrusted input, authentication, sensitive data, and external service integrations.

★ 107k FS 52 Use with care 13d ago
Dev & Engineering

Idea Refine

Turn vague ideas into tested, actionable product directions.

★ 107k FS 51 Use with care 13d ago
Dev & Engineering

Pre-Merge Code Quality Review

Review every change across correctness, readability, architecture, security, and performance before it reaches the main branch.

★ 107k FS 49 Use with care 13d ago
Dev & Engineering

Systematic Debugging & Recovery

A structured workflow for finding root causes, fixing failures, and preventing recurrence.

★ 107k FS 49 Use with care 13d ago

Related skills