CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-driven-development

Guide for implementing and maintaining context as a managed artifact alongside code, enabling consistent AI interactions and team alignment through structured project documentation.

Quality

56%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/context-driven-development/SKILL.md

The canonical home for this skill is context-driven-development in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

56%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 genuinely useful, concrete guidance on the Conductor artifact system, workflow, and maintenance triggers, but it is a monolithic ~400-line document padded with rationale sections. The only progressive-disclosure pointer is buried and references a nonexistent file, so all detail lives inline.

Suggestions

Cut the 'Benefits' section, the tautological 'Do not use this skill when' bullets, the generic 'Instructions' section, and the duplicated intro line — roughly 60 lines of content Claude neither needs nor acts on.

Move the artifact catalog (contents + update triggers), the validation checklist, and the session-continuity procedures into reference files (e.g. references/artifacts.md, references/validation-checklist.md) linked with clearly signaled 'See X for Y' pointers, keeping SKILL.md as a lean overview.

Fix or remove the reference to resources/implementation-playbook.md — the file does not exist in the bundle — and either ship it or point to a real path; add explicit recovery steps (e.g. what to do when a validation checklist item fails) to strengthen the workflow's feedback loops.

DimensionReasoningScore

Conciseness

Several sections are pure padding: the ~22-line 'Benefits' section explaining why the practice is good, the tautological 'Do not use this skill when' ('The task is unrelated to context-driven development'), the generic 'Instructions' filler ('Apply relevant best practices and validate outcomes'), IDE-integration fluff, and the frontmatter description repeated verbatim as the intro. This matches anchor 2 (noticeably verbose; several unnecessary explanations or padded sections) — the genuinely useful artifact schemas and checklists keep it above anchor 1.

2 / 5

Actionability

For an instruction-only skill the guidance is mostly executable: the /conductor:setup command, per-artifact contents lists with explicit 'Update when' triggers, a concrete directory tree, numbered session start/end/interruption procedures, and validation checklists with specific file names. It stays at anchor 4 rather than 5 because there are no sample artifact contents and the 'Instructions' section is vague filler.

4 / 5

Workflow Clarity

The Context → Spec & Plan → Implement workflow is explicitly sequenced, and 'Verify Context Before Implementation' provides checkpoints (read artifacts, flag outdated info, propose updates, confirm with stakeholders), supplemented by a validation checklist and session-continuity procedures. No destructive or batch operations apply the cap. It falls short of anchor 5 only because explicit error-recovery/feedback loops are thin (e.g., no instruction for what to do when validation fails or a stakeholder rejects a context update).

4 / 5

Progressive Disclosure

The body is well-sectioned with clear headers, but ~400 lines inline everything — the full artifact catalog, checklists, session procedures, and tool integrations — that clearly belongs in one-level-deep reference files, and the sole external reference ('resources/implementation-playbook.md') is buried in the Instructions section and points to a file that does not exist in the bundle. This matches anchor 3 (some structure; references present but not clearly signaled; content that should be separate is inline); the broken, unsignaled reference prevents a 4.

3 / 5

Total

13

/

20

Passed

Description

37%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.

The description communicates a clear 'what' but is written in abstract, buzzword-heavy language with no concrete actions, no natural trigger terms (Conductor, context-driven development), and no 'use when' guidance. It would be hard for a user or model to select this skill over generic documentation skills based on the description alone.

Suggestions

Add an explicit 'Use when...' clause with concrete triggers, e.g. 'Use when setting up a Conductor project, onboarding to an existing Conductor codebase, or deciding when to update context artifacts like product.md or tech-stack.md.'

Replace abstract phrasing ('managed artifact', 'team alignment') with concrete actions: 'Create and maintain context artifacts (product.md, tech-stack.md, workflow.md, tracks.md) alongside code via /conductor:setup'.

Include the natural keywords users would actually say — 'Conductor', 'context-driven development', 'project context', 'AI session continuity' — to improve trigger matching and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ('implementing and maintaining context as a managed artifact alongside code, structured project documentation') but the actions are generic and wrapped in buzzwords ('managed artifact', 'team alignment'), with no concrete operations such as the artifacts involved or the /conductor:setup command. It matches anchor 2 (names the domain but actions are minimal or generic) rather than 3, which would require 1-2 concrete actions.

2 / 5

Completeness

The 'what' is stated clearly ('implementing and maintaining context as a managed artifact alongside code'), but there is no 'Use when...' clause or equivalent trigger guidance, which per the rubric caps completeness at 3. This matches anchor 3 (clear what, when missing) exactly, not 4 which requires both.

3 / 5

Trigger Term Quality

Keywords are limited to generic terms ('context', 'project documentation', 'AI interactions'); 'managed artifact' is jargon users would not naturally say, and the natural trigger phrases (Conductor, context-driven development, project setup) are absent. This sits between anchors 2 and 3, but the buzzword-heavy framing with no natural user phrases pulls it to 2.

2 / 5

Distinctiveness Conflict Risk

The context-management methodology niche is somewhat specific, but the broad documentation/team-alignment framing ('structured project documentation', 'team alignment') could overlap with documentation, onboarding, or CLAUDE.md-style skills. Anchor 3 (somewhat specific but could still overlap) fits better than 4, since the overlap risk extends beyond closely related skills.

3 / 5

Total

10

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/context-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.