CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

70

1.14x
Quality

56%

Does it follow best practices?

Impact

97%

1.14x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./plugins/conductor/skills/context-driven-development/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
wshobson/agents
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.