CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

source-driven-development

Grounds every implementation decision in official documentation. Use when you want to verify an approach against the official docs before implementing it, or when you want authoritative, source-cited code free from outdated patterns. Use when building with any framework or library where correctness matters.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers a crisp, highly actionable four-step workflow with excellent validation checkpoints and copy-paste templates. Its weakness is token efficiency: the rationalizations table and the Red Flags/Verification redundancy add persuasive padding Claude does not need, and a leaner core file with reference files would improve disclosure.

Suggestions

Cut or compress the 'Common Rationalizations' table to the two or three most likely failure modes, or fold the rebuttals into the relevant process steps — the full persuasion table is padding Claude doesn't need.

Merge 'Red Flags' into the 'Verification' checklist (e.g. as negative-form checklist items) to eliminate near-duplicate content between the two sections.

Move the retrieval-safety details and the source-hierarchy table into a one-level-deep reference file (e.g. references/sources.md) and keep only the essential rules inline, shrinking the always-loaded SKILL.md body.

DimensionReasoningScore

Conciseness

The four-step core process is efficient and concrete, but the "Common Rationalizations" persuasion table (e.g. "'Fetching docs wastes tokens' | Hallucinating an API wastes more") and the heavy redundancy between the "Red Flags" list and the "Verification" checklist are unnecessary padding. This is more than the 'minor instances' of the 4 anchor, though most sections remain efficient, keeping it above 2.

3 / 5

Actionability

Fully actionable for an instruction-only skill: a dependency-file mapping table, exact fetch targets ("react.dev/reference/react/useActionState"), and copy-paste-ready templates for every common case — STACK DETECTED, CONFLICT DETECTED, in-code citations, and the UNVERIFIED flag — covering the workflow end to end.

5 / 5

Workflow Clarity

The DETECT → FETCH → IMPLEMENT → CITE sequence is explicitly numbered with checkpoints at each step (ask the user on ambiguous versions, surface conflicts with options, flag unverified patterns) plus a final verification checklist. Feedback loops and error-recovery paths are present, matching the top anchor; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Well-organized single file with clear section headers, and it properly delegates the prompt-injection threat model to the `security-and-hardening` skill instead of duplicating it. It falls short of 5 because at ~210 lines with no bundle files, material like the retrieval-hygiene section and source hierarchy could live in one-level-deep reference files to slim the always-loaded body.

4 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what and when clauses, third-person voice, and natural trigger phrases. Its main weakness is broad framing ("any framework or library where correctness matters") and action phrasing that circles one theme rather than enumerating distinct capabilities.

DimensionReasoningScore

Specificity

Names the domain and several concrete actions — "Grounds every implementation decision in official documentation", "verify an approach against the official docs", "source-cited code" — with minor gaps. It stays at 4 rather than 5 because the actions are variations on one verify-and-cite theme rather than a comprehensive list of distinct capabilities.

4 / 5

Completeness

Clearly answers both what ("Grounds every implementation decision in official documentation", "authoritative, source-cited code") and when, with two explicit "Use when..." clauses containing concrete trigger conditions. It matches the top anchor because both halves are explicit and specific.

5 / 5

Trigger Term Quality

Includes natural phrases users would say — "official docs", "verify an approach", "outdated patterns", "framework or library" — but misses common synonyms such as "best practices", "up-to-date", or "API reference", so coverage is good rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

The verify-against-official-docs niche is mostly distinct from other skills, but the trigger "building with any framework or library where correctness matters" is broad, leaving minor overlap risk with general research or documentation skills. Not 5 because that breadth means it could fire in many coding contexts.

4 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

addyosmani/agent-skills

Path

skills/source-driven-development/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.