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.
70
56%
Does it follow best practices?
Impact
97%
1.14xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./plugins/conductor/skills/context-driven-development/SKILL.mdQuality
Discovery
92%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description that clearly articulates specific capabilities and provides explicit trigger guidance via a 'Use when...' clause. The named artifacts and directory structure add concreteness. The main weakness is that some trigger terms ('setting up a project', 'product docs', 'workflows') are broad enough to potentially conflict with other project management or documentation skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: creates/maintains context artifacts (with named files), scaffolds new projects, extracts context from existing codebases, validates artifact consistency, and synchronizes documents. Very concrete and actionable. | 3 / 3 |
Completeness | Clearly answers both 'what' (creates/maintains project context artifacts, scaffolds, extracts, validates, synchronizes) and 'when' with an explicit 'Use when...' clause listing seven distinct trigger scenarios. | 3 / 3 |
Trigger Term Quality | Includes strong natural trigger terms users would say: 'setting up a project', 'product docs', 'tech stack', 'development workflows', 'tracking work', 'onboarding', 'project scaffolding'. These cover a wide range of natural user phrasings. | 3 / 3 |
Distinctiveness Conflict Risk | While the specific artifact names (product.md, tech-stack.md, etc.) and the `conductor/` directory provide some distinctiveness, terms like 'setting up a project', 'product docs', and 'development workflows' are broad enough to potentially overlap with general project management or documentation skills. | 2 / 3 |
Total | 11 / 12 Passed |
Implementation
20%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is a verbose conceptual guide that reads more like a methodology whitepaper than an actionable skill for Claude. It spends most of its token budget explaining philosophy, benefits, and anti-patterns that Claude doesn't need, while providing almost no concrete examples, executable commands, or template content. The actual actionable guidance (what to put in each file, how to run setup, how to validate) is either absent or deferred to an external template file.
Suggestions
Replace the descriptive 'Contents' lists for each artifact with actual example content snippets showing what a good product.md, tech-stack.md, etc. looks like (copy-paste ready templates).
Remove or drastically condense the 'Benefits', 'Core Philosophy', 'Common Anti-Patterns', 'Integration with Development Tools', and 'Best Practices' sections — these explain concepts Claude already understands and consume significant tokens.
Add concrete, executable examples: show actual file contents, actual validation commands, and actual setup workflows rather than abstract descriptions of what they should do.
Split detailed reference content (session continuity procedures, CI/CD integration, IDE setup) into separate reference files and link to them from a concise overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Extremely verbose at ~300+ lines. Much of the content explains concepts Claude already knows (what product docs are, benefits of documentation, anti-patterns like 'stale context'). Sections like 'Benefits', 'Core Philosophy', 'Common Anti-Patterns', and 'Best Practices' are largely generic advice that wastes tokens. The IDE integration and git hooks sections describe general concepts rather than providing actionable specifics. | 1 / 3 |
Actionability | Despite its length, the skill contains zero executable code, no concrete commands (references like '/conductor:setup' are unexplained), no example file contents, and no copy-paste ready templates. It describes what artifacts should contain but never shows actual examples of content. The referenced 'artifact-templates.md' is where the actionable content apparently lives, but nothing concrete is provided here. | 1 / 3 |
Workflow Clarity | The high-level workflow (Context → Spec & Plan → Implement) is stated, and there are numbered steps for greenfield/brownfield setup, session continuity, and context maintenance. However, validation steps are checklists without concrete verification commands, and the feedback loops are vague ('Flag any outdated information', 'Propose updates before proceeding'). No concrete validation tooling or commands are provided. | 2 / 3 |
Progressive Disclosure | There is one reference to 'references/artifact-templates.md' for templates, which is good. However, the massive amount of inline content (anti-patterns, benefits, best practices, IDE integration, CI/CD integration) should be split into separate reference files. The skill tries to be both an overview and a comprehensive guide, resulting in a monolithic document that would benefit from better content splitting. | 2 / 3 |
Total | 6 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
70444e5
Table of Contents
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.