CtrlK
BlogDocsLog inGet started
Tessl Logo

context-driven-development

Use this skill when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md, and workflow.md files.

65

1.57x
Quality

51%

Does it follow best practices?

Impact

85%

1.57x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./tests/ext_conformance/artifacts/agents-wshobson/conductor/skills/context-driven-development/SKILL.md

The canonical home for this skill is context-driven-development in wshobson/agents

SKILL.md
Quality
Evals
Security

Quality

Content

42%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 well-organized and grounded in named Conductor artifacts, but it is a ~380-line monolithic conceptual document: generic philosophy and benefits padding, abstract rather than executable instructions, and no progressive disclosure despite abundant material (artifact specs, checklists, directory layout) that belongs in referenced files. It reads more like internal project documentation than an operational skill. Trimming the conceptual sections and splitting reference material into bundled files would improve every dimension.

Suggestions

Cut the Core Philosophy, Benefits, and Institutional Memory sections (~70 lines of generic rationale Claude can infer) and keep only the operative principles in a short list.

Move the per-artifact Contents/Update-when reference and the Context Validation Checklist into files under references/ (e.g. references/artifacts.md, references/validation-checklist.md) linked one level deep from SKILL.md.

Make the workflow phases executable: give the concrete steps and commands for each phase (Context, Spec, Plan, Implement) and add explicit verify-then-proceed checkpoints, including what to do when validation flags stale or conflicting artifacts.

DimensionReasoningScore

Conciseness

Quotes: "Context-Driven Development treats project context as a first-class artifact managed alongside code...", "New team members onboard faster with explicit context", "Decisions and rationale are preserved / Context survives team changes". The Core Philosophy and four Benefits sections (~50 lines) explain generic principles and obvious consequences that add little instructional value, and the Anti-Patterns Problem/Solution format pads simple one-line advice. Not a 1 because the artifact sections do carry project-specific information Claude would not know; not a 3 because the Benefits and Philosophy sections in particular are clearly trimmable padding across a ~380-line body.

2 / 5

Actionability

Quotes: "Run `/conductor:setup` to create all artifacts interactively", "Move feature from 'planned' to 'implemented' in product.md", "1. Check if existing dependencies solve the need / 2. Document the rationale...". Named commands, named files, and numbered procedures give some concrete guidance, but much of the direction stays abstract ("Ensure changes in one artifact reflect in related documents", "Configure your IDE to display context files prominently") with no examples, templates, or exact commands. Not a 4 because key operations — updating an artifact, running setup on a brownfield repo — lack executable detail; not a 2 because the named files and /conductor:setup steps are genuinely actionable.

3 / 5

Workflow Clarity

Quotes: "1. Context Phase... 2. Specification Phase... 3. Planning Phase... 4. Implementation Phase", "Before starting any track: 1. Read all context artifacts / 2. Flag any outdated information", and the Context Validation Checklist with "[ ] product.md reflects current product vision". The phases and a pre-implementation checklist exist, but each phase has no concrete steps or commands beyond /conductor:setup, and there are no error-recovery or feedback checkpoints (what to do when validation fails, when artifacts conflict). Not a 4 because the checkpoints are implicit/abstract rather than explicit verify-then-proceed gates like the anchor's "**Validate**: ... 4. If errors: fix and re-validate".

3 / 5

Progressive Disclosure

The body is a single ~380-line document with no bundle files (no references/, scripts/, or assets/ exist) and no external references at all. Section headers are clear and consistently organized (## Artifact Relationships, ## Directory Structure, ## Context Validation Checklist), which lifts it above a wall of text, but long reference material — per-artifact content lists, the validation checklist, session-continuity procedures — is inlined in SKILL.md where the rubric expects it split into one-level-deep referenced files. Not a 2 because the in-section structure is good and nothing is buried; not a 4 because essentially all detail lives in the top-level file with zero disclosure layers.

3 / 5

Total

11

/

20

Passed

Description

61%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 has an explicit, concrete 'Use when' clause anchored to named artifacts, which gives it good trigger quality and distinctiveness within the Conductor ecosystem. However, it never states what the skill does as a capability — the 'what' only leaks through gerunds inside the trigger clause, and the action verbs are generic. Leading with one or two concrete capabilities before the trigger clause would raise completeness and specificity.

Suggestions

Add an explicit 'what' statement before the trigger clause, e.g. "Sets up and maintains Conductor project context artifacts (product.md, tech-stack.md, workflow.md, tracks.md), validates them before implementation, and onboards new and existing codebases."

Replace generic verbs ("working with", "managing", "understanding the relationship") with concrete capabilities like "create, update, and validate" so the skill's actions are enumerable.

Include the other artifact names (tracks.md, product-guidelines.md) and common user phrases like "project setup", "onboarding", or "greenfield/brownfield" to widen natural trigger coverage.

DimensionReasoningScore

Specificity

Quotes: "working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md, and workflow.md files." The domain is clearly named and two actions appear ("managing... artifacts", "understanding the relationship"), but the verbs are generic — there is no list of concrete capabilities (create, update, validate, onboard) like the score-4/5 anchors require. Not a 2 because the named artifacts do ground the actions in something concrete; not a 4 because no specific actionable capability list is present.

3 / 5

Completeness

Quotes: "Use this skill when working with..., managing..., or understanding the relationship between..." The 'when' is explicit and reasonably concrete, but the entire description is one trigger clause — the 'what' (what the skill actually does: set up projects, maintain artifacts, run validation) is only weakly implied by the gerunds inside the when-clause, never stated independently. Not a 2 because the embedded actions give a partial 'what'; not a 4 because a distinct, explicit statement of capability is absent.

3 / 5

Trigger Term Quality

Quotes: "Conductor's context-driven development", "project context artifacts", "product.md, tech-stack.md, and workflow.md". Concrete artifact filenames are natural terms a user on a Conductor project would say, giving good keyword coverage. Not a 5 because common variations are missing — no "tracks.md", "product-guidelines.md", "onboarding", "setup", "greenfield/brownfield", or generic phrases like "project documentation".

4 / 5

Distinctiveness Conflict Risk

Quotes: "Conductor's context-driven development methodology", "product.md, tech-stack.md, and workflow.md files". The tool name and specific artifact filenames create a clear niche with distinct triggers. Not a 5 because the middle clause "managing project context artifacts" is broad enough to overlap with generic documentation/context-management skills.

4 / 5

Total

14

/

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
Dicklesworthstone/pi_agent_rust
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.