CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

context-driven-development

Creates and maintains project context artifacts (product.md, tech-stack.md, workflow.md, tracks.md) in a `conductor/` directory. Scaffolds new projects from scratch, extracts context from existing codebases, validates artifact consistency before implementation, and synchronizes documents as the project evolves. Use when setting up a project, creating or updating product docs, managing a tech stack file, defining development workflows, tracking work units, onboarding to an existing codebase, or running project scaffolding.

60

Quality

76%

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 ./plugins/conductor/skills/context-driven-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

47%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 is a genuinely lean overview with a clean pointer to a detailed reference file, but it delegates almost everything — including the core workflow and validation checklists — without summarizing even the essential steps. As a result a reader of SKILL.md alone cannot act on the skill.

Suggestions

Add a short inline workflow summary (e.g. the Context → Spec & Plan → Implement phases with a validation checkpoint before implementation) so the body is actionable without opening references/details.md.

Make Best Practices concrete: name which artifacts to read, where the context validation checklist lives, and the commands/steps for greenfield and brownfield setup instead of directives like "Read context first".

Surface references/artifact-templates.md in the SKILL.md navigation alongside references/details.md so both bundle files are discoverable from the top level.

DimensionReasoningScore

Conciseness

The ~40-line body is lean with no explanation of concepts Claude already knows, and the pointer to references/details.md is a single well-earned sentence. It is not 5 because the intro sentence ("enabling consistent AI interactions and team alignment through structured project documentation") and the "When to Use This Skill" list largely restate the description and could be trimmed.

4 / 5

Actionability

The Best Practices are high-level directives ("Read context first: Always read relevant artifacts before starting work", "Run context validation checklist before major work") with no commands, paths, or artifact locations in the body; all executable material lives in references/details.md. This matches "high-level hints but missing the specific steps to execute" rather than 3, which requires at least some concrete inline guidance.

2 / 5

Workflow Clarity

The body contains no sequenced process at all — the Context → Spec & Plan → Implement workflow, setup steps, and validation checklists exist only in the referenced file. It avoids 1 solely because the pointer to that workflow is clearly signaled, and cannot reach 3 because the body itself has no sequence or checkpoints.

2 / 5

Progressive Disclosure

The body is short, well-sectioned, and clearly signals references/details.md (which exists), and details.md in turn links to references/artifact-templates.md (also present). It is not 5 because artifact-templates.md is absent from the top-level navigation and only discoverable one file deeper, a minor organization gap.

4 / 5

Total

12

/

20

Passed

Description

96%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: third-person, concrete about what it does and where artifacts live, and with an explicit, multi-scenario "Use when" clause. The only residual risk is mild trigger overlap with generic project-setup or documentation skills.

DimensionReasoningScore

Specificity

The description lists five concrete actions ("Creates and maintains project context artifacts (product.md, tech-stack.md, workflow.md, tracks.md)", "Scaffolds new projects from scratch", "extracts context from existing codebases", "validates artifact consistency", "synchronizes documents") with named artifacts, giving comprehensive coverage. It is not 4 because there is no meaningful gap in the action inventory.

5 / 5

Completeness

Both halves are explicit: the "what" (creates/scaffolds/extracts/validates/synchronizes context artifacts in a `conductor/` directory) and a full "Use when..." clause with seven concrete triggers. This mirrors the anchor-5 example structure of capabilities followed by explicit trigger guidance.

5 / 5

Trigger Term Quality

"Use when setting up a project, creating or updating product docs, managing a tech stack file, defining development workflows, tracking work units, onboarding to an existing codebase, or running project scaffolding" covers the natural phrasings a user would actually say, supplemented by concrete artifact filenames. Score 4 would require missing natural terms, and none of significance are absent.

5 / 5

Distinctiveness Conflict Risk

The `conductor/` directory and named artifacts (product.md, tech-stack.md, tracks.md) carve a clear niche with mostly distinct triggers. It is not 5 because generic phrases like "setting up a project" and "creating or updating product docs" could overlap with general scaffolding or documentation-writing skills.

4 / 5

Total

19

/

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

wshobson/agents

Path

plugins/conductor/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.