CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

github-refactor-findings

The GitHub issues tracker for refactor findings: issues labeled refactor-findings in the fragility repo, with the plan in the body. Read when fragility-common/config.json sets tracker to github and you need to know how findings map onto issues, or when changing that mapping.

Quality

88%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 lean, invariant-dense reference that documents the findings-to-issues mapping with exact markers, labels, key formats, and lifecycle semantics, and correctly delegates operations to the fragility-common scripts. Workflow clarity stops just short of the top anchor only because the mapping-change path lacks an explicit step sequence.

DimensionReasoningScore

Conciseness

Every line states an invariant or rule ("The scripts rewrite only the marked sections, so people can edit the rest of the body", "It is never re-filed") with no padding and no explanation of concepts Claude already knows, such as what GitHub issues are. This matches anchor 5 (lean, assumes competence, every token earns its place) rather than anchor 4's "minor instances of over-explanation".

5 / 5

Actionability

The guidance is fully concrete for an instruction-only skill: exact markers ("<!-- fragility-plan:start ... -->", "<!-- fragility-finding {json} -->"), the exact label, three accepted key formats ("#<n>", bare number, issue URL), precise close-state reasons ("closed as not planned or duplicate"), and the named commands to use (findings-doctor, findings-match, findings-upsert). Specific rules cover all the common lifecycle cases, matching anchor 5; there are no missing key details that would drop it to anchor 4.

5 / 5

Workflow Clarity

The lifecycle semantics are coherent (sighting to comment with cooldown, new plan replaces the marked section, fixed closes as completed with a recurrence issue, declined is never re-filed) and validation tooling is named via findings-doctor and the auth/access prerequisites. However, for the description's second trigger, "changing that mapping", there is no explicit step sequence or checkpoint, which fits anchor 4 (clear with minor validation gaps) rather than anchor 5's explicit feedback loops.

4 / 5

Progressive Disclosure

The body is under 50 lines, self-contained, and well organized into settings and a per-state mapping section, with the one cross-skill reference (factory-run) clearly signaled by name. The bundle's scripts/ (github.ts, tracker.ts) are implementation loaded by fragility-common's machinery rather than documentation to disclose, so inlining or referencing them would add tokens without value; this matches the simple-skill case for anchor 5.

5 / 5

Total

19

/

20

Passed

Description

82%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 tight, concrete description with an explicit "Read when..." trigger clause tied to a specific config setting and two precise conditions. Its only weakness is that it defines the artifact rather than enumerating the skill's actions, which leaves specificity at the middle anchor.

Suggestions

Name the skill's concrete actions alongside the artifact definition, e.g. "documents how findings, plans, and sightings are filed, updated, and closed as GitHub issues", to lift specificity.

Add one or two natural synonyms such as "tickets" or "issue tracking" to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"issues labeled refactor-findings in the fragility repo, with the plan in the body" names the domain and its concrete artifacts, but the description defines what the skill is rather than listing several actions it performs. It is above anchor 2 because the identifying details are concrete (label, repo, plan location), and below anchor 4 because there is no multi-action capability list.

3 / 5

Completeness

Both halves are explicit: the what ("The GitHub issues tracker for refactor findings: issues labeled refactor-findings in the fragility repo, with the plan in the body") and a concrete when clause ("Read when fragility-common/config.json sets tracker to github and you need to know how findings map onto issues, or when changing that mapping"). This clearly matches the anchor-5 example structure with concrete trigger conditions, not the less-explicit when of anchor 4.

5 / 5

Trigger Term Quality

Natural phrases a user in this codebase would say are present: "GitHub issues tracker", "refactor findings", "tracker to github", "findings map onto issues". A few natural variations (e.g., "tickets", "issue tracker") are missing, so it fits anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The niche is sharply delimited by the refactor-findings label, the fragility repo, and the config.json tracker setting, so it is unlikely to trigger for the wrong skill. This matches anchor 5 (clear niche with distinct triggers, minimal conflict risk); anchor 4's "minor overlap risk" does not apply given the internal-scope gating.

5 / 5

Total

17

/

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/github-refactor-findings/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.