CtrlK
BlogDocsLog inGet started
Tessl Logo

enrich-acceptance-criteria

Enriches each user story's acceptance criteria with a "Relevant constraints" line pointing to the specific architecture decisions, implementation heuristics, design principles, and UI kit that apply to that story. Use this skill after any phase that introduces new constraints — after architecture decisions are written (Phase 3), after the UI kit is approved (Phase 4), and after implementation heuristics and design principles are established (Phase 5). Also invoke whenever a Phase 6 agent reads the acceptance criteria and lacks a clear picture of which constraints govern a particular story. Safe to re-run at any phase — each invocation only adds constraints not already listed; nothing is ever removed from an existing entry.

70

Quality

85%

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

82%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.

A well-structured, actionable instruction skill with concrete formats, exact paths, and a closing quality checklist. The main gaps are a missing explicit retry loop for the batch update and a few rationale paragraphs that could be trimmed for token efficiency.

Suggestions

Add an explicit feedback loop after the Output Quality Check (e.g. 'If any checklist item fails, return to the affected story section, correct it, and re-verify') to lift workflow_clarity on this batch operation.

Tighten the two opening rationale paragraphs — the Phase 1 / Phase 6 framing is useful but could be condensed to respect the token budget.

Consider moving the detailed 'Determining Relevance' rules into a short reference bundle so SKILL.md stays a leaner overview, which would also strengthen progressive_disclosure.

DimensionReasoningScore

Conciseness

The body is mostly lean and purposeful, with sectioned guidance on inputs, relevance, update steps, format, fallback, and a quality checklist. A few rationale paragraphs (e.g. explaining why criteria are written before architecture exists) could be tightened, but no padding of concepts Claude already knows, so it sits above the midpoint rather than at the lean 5.

4 / 5

Actionability

Concrete and executable for an instruction-only skill: exact file paths, the precise 'Relevant constraints:' line format with a copy-ready markdown example, the '## [US-XX] Story title' section pattern, and explicit branch logic for when the line exists vs. does not. The rubric's instruction-only exception applies, so the absence of code is not penalized.

5 / 5

Workflow Clarity

A clear sequence (Input Documents → Determining Relevance → How to Update → Format → Fallback → Output Quality Check) with conditional branching and a closing verification checklist. It is a batch operation over every story section, and while the checklist provides checkpoints, there is no explicit validate→fix→retry feedback loop, capping it just below 5.

4 / 5

Progressive Disclosure

Well-organized into clearly headed sections with no nested or buried references; all content is appropriately inline and self-contained. No bundle files exist to reference, and at ~75 lines it exceeds the under-50-line simple-skill threshold that would allow a 5 on structure alone, so it sits at a strong 4.

4 / 5

Total

17

/

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, third-person description that clearly states both what the skill does and when to invoke it, tied to specific project phases. Minor room to broaden natural trigger phrasing, but distinctiveness and completeness are excellent.

DimensionReasoningScore

Specificity

Describes one core action (adds a 'Relevant constraints' line) but enumerates the specific constraint sources it points to — 'architecture decisions, implementation heuristics, design principles, and UI kit'. Several specific targets are named, but it is a single enrichment action rather than a list of multiple distinct operations, so it sits just below the comprehensive 5.

4 / 5

Completeness

Explicitly states what it does (enriches each story's criteria with a Relevant constraints line) and when to use it (after Phases 3/4/5, and whenever a Phase 6 agent lacks constraint clarity), with concrete trigger phrases. Both what and when are clearly and explicitly answered.

5 / 5

Trigger Term Quality

Concrete triggers like 'after architecture decisions are written (Phase 3)', 'after the UI kit is approved (Phase 4)', and 'whenever a Phase 6 agent reads the acceptance criteria' give good natural-phrase coverage of the domain. A few common phrasings a user might actually say are absent, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche — annotating acceptance criteria with governing constraints inside a phased project workflow — with phase-specific triggers that make overlap with unrelated skills unlikely.

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Simonvm9114/flag-feedback
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.