CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

identify-fragile-systems

Nightly refactor review: find the systems the last day's commits hit hardest, use three weeks of history to tell fragile from fast-moving, write a plan per systemic fix, and file deduplicated Jira tickets. Use for /identify-fragile-systems or the nightly run. For a single bug report, use investigate-bug instead.

Quality

92%

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

92%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 tight, well-structured orchestration skill: the 9-step nightly pipeline is concrete and sequenced, with preflight gates, a dry-run-before-apply filing pattern, exit-code-driven feedback loops, and an explicit decisions ledger. Detail is appropriately delegated one level deep to four named sub-skills. The only gap is that two script invocations ($H/pr.ts, $P/new-plan.ts) are named without argument syntax.

Suggestions

Show the invocation shape for $H/pr.ts and $P/new-plan.ts (e.g. '$H/pr.ts --run $RUN --pr <number>'), even in one-line examples, since they are the only commands used without any argument syntax.

Define or link <dataDir> where it is first used in step 7, since its value is not stated in this file and is only implicitly owned by fragility-common.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout — e.g. 'Planning only. Never change product code, open a PR, or push' and 'Exit 2 is never a pass' — with zero padding and no explanation of concepts Claude already knows. Every token earns its place; not even minor trimming is apparent (anchor 4), so anchor 5 fits.

5 / 5

Actionability

Most commands are concrete and flag-complete ('$H/collect.ts --run $RUN', '$J/jira-upsert.ts --run $RUN --key <KEY> --system <system> --apply', '$S/summarize.ts --run $RUN'), matching anchor 4's 'concrete code or commands with minor gaps'. It falls short of anchor 5 ('copy-paste ready... common cases') because two invocations are named without any argument syntax — 'read 3 to 6 fix PRs with `$H/pr.ts`' and 'Scaffold it with `$P/new-plan.ts`' — and `<dataDir>` is never defined in this file.

4 / 5

Workflow Clarity

Nine numbered steps in a clear sequence with explicit validation checkpoints and feedback loops: preflight doctors with 'Stop on any nonzero exit', '$J/jira-upsert.ts --plan <file>` (a dry run), then add `--apply'', and 'Exit 1 means some hot system is still undecided, so go back to step 7'. This matches anchor 5 (explicit validation steps, error-recovery loops, checklist-style hard rules) rather than anchor 4, which has 'minor validation gaps'.

5 / 5

Progressive Disclosure

The body is a clear orchestrator overview that states 'each step's details live in that skill's SKILL.md' and maps exactly which of the four sub-skills owns what (history/scoring, Jira dedup, plans, run format), with one-level-deep pointers like '.agents/skills/refactor-plan/references/rubric.md'. The bundle's own script (scripts/summarize.ts) is referenced in the body as '$S/summarize.ts', so referenced paths resolve; this matches anchor 5 (clear overview, well-signaled one-level-deep references, content appropriately split) rather than anchor 4, which would leave organization gaps.

5 / 5

Total

19

/

20

Passed

Description

92%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 concretely names all four phases of the workflow, gives an explicit 'Use for' trigger tied to the slash command and the nightly run, and disambiguates against a sibling bug-investigation skill. Voice is appropriately third-person/declarative with no fluff. The only improvement space is broader natural-language synonyms in the trigger phrasing.

DimensionReasoningScore

Specificity

It lists multiple specific concrete actions covering the whole workflow: 'find the systems the last day's commits hit hardest', 'use three weeks of history to tell fragile from fast-moving', 'write a plan per systemic fix', and 'file deduplicated Jira tickets' — comprehensive coverage matching anchor 5. It exceeds anchor 4 ('several specific actions; minor gaps') because no part of the skill's job is left unnamed.

5 / 5

Completeness

Both halves are explicit: the 'what' is the four concrete actions, and the 'when' is stated as 'Use for /identify-fragile-systems or the nightly run' with the boundary 'For a single bug report, use investigate-bug instead'. This matches anchor 5 ('clearly and explicitly answers both what AND when with concrete trigger phrases') rather than anchor 4, where the 'when' would be less explicit.

5 / 5

Trigger Term Quality

Good keyword coverage with natural terms: 'nightly refactor review', 'fragile', 'fast-moving', 'Jira tickets', 'commits', plus the explicit triggers '/identify-fragile-systems' and 'the nightly run' — matching anchor 4's 'good keyword coverage; a few natural terms missing'. It falls short of anchor 5 (comprehensive synonyms) because common variations users might say — e.g. 'tech debt', 'hot spots', 'code churn', 'flaky' — are absent, though it is clearly above anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (nightly system-level refactor triage with Jira filing) and actively reduces conflict risk with the disambiguation 'For a single bug report, use investigate-bug instead' — anchor 5's 'clear niche with distinct triggers; minimal conflict risk'. Anchor 4 would require minor overlap risk with closely related skills, which the explicit routing rule preempts.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

BuilderIO/agent-native

Path

.agents/skills/identify-fragile-systems/SKILL.md

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.