Dev & Engineering official-documentationframework-verificationsource-citationversion-awarenessapi-correctness

Source-Driven Development

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

FollowSkills review · FSRS-2.0
Not recommended
51/ 100 5-point scale 2.6 / 5
Trust16 / 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.

Reliability8 / 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.

Adaptability9 / 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.

Convention8 / 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.

Effectiveness6 / 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.

Verifiability4 / 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.

Evidence confidence:Low Reviewed Jul 20, 2026 Reviewed revision 2fbfa004a019
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.
Review evidence [1][2][3][4][5]
See the full review method →

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.

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

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 do you install this skill?

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.

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.

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.

Dev & Engineering

Planning & Task Breakdown

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

Dev & Engineering

Doubt-Driven Development

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

Dev & Engineering

Incremental Implementation

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

Dev & Engineering

Stable Interface Design

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

Dev & Engineering

Context Engineering

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

Dev & Engineering

Engineering Workflow Navigator

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

Dev & Engineering

Browser DevTools Testing

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

Dev & Engineering

Intent Interviewer

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

Dev & Engineering

Test-Driven Development Workflow

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

Dev & Engineering

Code Clarity Refactor

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

Dev & Engineering

Spec-Driven Development

Turn ambiguous engineering requests into testable specifications before coding.

Dev & Engineering

Git Workflow & Release Discipline

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

Dev & Engineering

Performance Optimization Engineering Skill

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

Design & Frontend

Production Frontend UI Engineering

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

Automation & Ops

Production Observability

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

Automation & Ops

Security Hardening Engineering Skill

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

Dev & Engineering

Idea Refine

Turn vague ideas into tested, actionable product directions.

Dev & Engineering

Pre-Merge Code Quality Review

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

Dev & Engineering

Systematic Debugging & Recovery

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

Related skills