CtrlK
BlogDocsLog inGet started
Tessl Logo

intent-driven-development

Turn ambiguous or high-impact product and engineering changes into scoped, verifiable acceptance criteria before or alongside implementation. Use when a user asks to clarify a feature, define acceptance criteria, de-risk a security/data/migration/integration change, prepare implementation requirements for another agent, or make a complex request testable. Do not trigger for trivial edits, straightforward fixes, active debugging, code review, or implementation requests whose acceptance conditions are already clear unless the user explicitly invokes this skill.

68

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 highly actionable and well-sequenced, with explicit validation gates and worked examples that make the expected output unambiguous. Its weaknesses are repetition (the business-constraints rule stated three times, overlapping Operating Rules and Workflow sections) and a fully monolithic ~360-line file where the template and examples could be split into referenced files.

Suggestions

State the repository-vs-business-constraints rule once (in Discover Context) and have Operating Rules #2 and the failing-context example reference it in one line instead of restating it; merge Operating Rule 10 into the 'Handle revision' step and Rule 6 into 'Present And Continue'.

Move the Full Acceptance Brief output template and the pass/fail examples into references/ files (e.g., references/template.md, references/pass-fail-examples.md) and link to them from the body, keeping SKILL.md as a lean overview.

Drop the duplicate full AC example: the 'Passing acceptance criterion' section can cite the Quick Capture AC-001 from the Examples section rather than reprinting it.

DimensionReasoningScore

Conciseness

Mostly dense, useful guidance, but with real redundancy over a ~360-line body: the repository-vs-business-constraints rule is stated near-verbatim three times (Operating Rules #2, the 'Discover Context' prose, and the failing-context example); Operating Rule 10 duplicates 'Handle revision' in How It Works; Rule 6 duplicates the save-to-file guidance in 'Present And Continue'; and the full passing AC example appears twice. Not 4 because the repetition is more than 'minor instances that could be trimmed'; not 2 because most sections still earn their tokens.

3 / 5

Actionability

Fully actionable for an instruction-only skill: a complete copy-paste-ready Full Acceptance Brief template (status, revision log, risk review table, AC-NNN fields, verification plan), a worked Quick Capture example, a boundary-category table with include-when conditions, and explicit pass/fail calibrations. Specific examples cover the common cases (quick capture, full brief, existing-spec review); anchor 4 would require notable gaps, which are absent.

5 / 5

Workflow Clarity

A clear six-phase Workflow (Establish Goal and Risk → Discover Context → Define Scope → Write Acceptance Criteria → Cover Relevant Boundaries → Present And Continue) with explicit validation checkpoints: a pre-return 'Quality Check' list, a yes/no 'Pass/Fail Rubric' gate, and a defined revision feedback loop ('[revised]', increment revision, re-present changed criteria). Matches the anchor-5 pattern of sequence plus explicit validation and feedback loops; not 4 because checkpoints are already explicit rather than mostly present.

5 / 5

Progressive Disclosure

The skill is a well-sectioned single file with no bundle files at all: the ~70-line output template, the pass/fail examples, and the boundary-category table are all inlined in a ~360-line SKILL.md, content that would naturally live in template/reference files loaded on demand. Sections are internally well organized, so this is above anchor 2 ('minimal structure'), but with zero references and everything inline it cannot reach anchor 4 ('most content appropriately placed; references mostly clear').

3 / 5

Total

16

/

20

Passed

Description

87%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: it states what the skill does, when to use it, and when not to, in concrete third-person language with genuine trigger phrases. The main lever for improvement is unpacking the compound action sentence into discrete actions and adding common synonyms (spec, acceptance tests, requirements).

DimensionReasoningScore

Specificity

Names several concrete actions — 'turn ambiguous or high-impact product and engineering changes into scoped, verifiable acceptance criteria', 'de-risk a security/data/migration/integration change', 'prepare implementation requirements for another agent', 'make a complex request testable' — but they arrive as one compound sentence rather than a clean enumerated action list, leaving minor coverage gaps (e.g., reviewing an existing PRD, which the body supports). Not 5 because the anchor-5 pattern is multiple discrete, comprehensively listed actions; not 3 because far more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both questions: the 'what' ('Turn ambiguous or high-impact product and engineering changes into scoped, verifiable acceptance criteria') and the 'when' via a concrete 'Use when...' clause listing five trigger conditions plus exclusions. Matches the anchor-5 example structure exactly; anchor 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Strong natural phrases users would actually say — 'clarify a feature', 'define acceptance criteria', 'de-risk', 'prepare implementation requirements', 'make a complex request testable' — plus explicit negative triggers ('trivial edits, straightforward fixes, active debugging, code review'). Not 5 because common synonyms like 'write a spec', 'acceptance tests', or 'requirements doc' are absent; not 3 because keyword coverage is broad and includes trigger and anti-trigger terms.

4 / 5

Distinctiveness Conflict Risk

Clear niche (acceptance-criteria specification before/alongside implementation) with distinct triggers, and an explicit do-not-trigger list ('trivial edits, straightforward fixes, active debugging, code review') that minimizes overlap with adjacent skills. Minimal conflict risk with other skills; not 4 because the negative triggers actively fence off the closest overlaps.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
affaan-m/ECC
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.