CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

prioritize-repo-issues

Prioritize open issues in a local GitHub repository workspace by value outcome framing and strategic goal alignment. Classifies backlog items across outcome altitude (Impact/Outcome vs Output vs Activity) and evaluates them against repository strategic goals (P0 Strategic Drivers down to P4 Distractions). Use when planning milestones or sprints, triaging an issue backlog, deciding what work to pull next, or auditing a repository queue for outcome and strategic focus.

Quality

80%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/prioritize-repo-issues/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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 delivers highly actionable, executable guidance organized as a clear two-pass workflow with explicit boundary-review checkpoints. Its weaknesses are repetition between the Outcome Indicators and Pass 2 sections, and a broken core reference — the entire tool hinges on scripts/prioritize_issues.py, which is not present in the bundle.

Suggestions

Consolidate the duplicated material: the prescriptive-verb flags, stale-item (≥90-day) rules, and P0–P4 tier descriptions each appear in both 'Outcome Indicators' and the Pass 2 coaching sections — state them once and reference them.

Ship the referenced scripts/prioritize_issues.py in the skill's scripts/ directory (or inline the heuristic guidance as a fallback), since every 'How to Run' command depends on a file that is not in the bundle.

Add a finalization step to the two-pass workflow — how to record/apply the resulting labels (e.g., via gh issue edit or a --json report) and what to do when the Pass 1 script errors — to close the remaining workflow-clarity gaps.

DimensionReasoningScore

Conciseness

Mostly efficient with no padding of concepts Claude already knows, but noticeably redundant: prescriptive-verb flags appear twice ("flagged as smells" in Outcome Indicators vs. "Look for prescriptive verbs: build, create, implement..." in Pass 2), stale rules appear twice (the ≥90-day bullet vs. the "Address Backlog Rot" section), and the P0–P4 grid is described in Outcome Indicators and again across Pass 2 sections 4–5. Not a 2 because there is no fluffy over-explanation; not a 4 because the repetition is more than minor and could be consolidated.

3 / 5

Actionability

Fully executable, copy-paste-ready commands covering the common cases ("python3 scripts/prioritize_issues.py --goals ...", "--no-auto-goals", "--repo owner/repo", "--json", "--limit 50 --stale-days 60") plus concrete Pass 2 guidance: a specific support-question example ("Is there a way to exclude X?"), named verb lists, and an outcome hypothesis template. This matches the top anchor.

5 / 5

Workflow Clarity

A clearly sequenced two-pass workflow where Pass 2's six numbered checks act as explicit validation checkpoints with feedback actions ("Demote pure support inquiries from P0 to P2", "label it duplicate/hold and move to P4"). Not a 5 because there is no guidance on what to do if the classifier fails or errors, and no step for finalizing/applying the resulting labels or grid; not a 3 because checkpoints are genuinely present and specific.

4 / 5

Progressive Disclosure

Section structure is well organized with clear headers and a logical overview-to-detail flow, but the core reference "scripts/prioritize_issues.py" does not exist in the skill's bundle (no scripts/ directory present), and the Source section points to "../../CREDITS.md" outside the skill. A load-bearing reference is broken, which is worse than the 'minor organization gaps' of level 4 but better than the unstructured level 2.

3 / 5

Total

15

/

20

Passed

Description

83%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: third-person voice, concrete actions with a defined P0–P4 taxonomy, and an explicit 'Use when' clause with four natural trigger phrases. Keyword coverage is good but misses a few common synonyms, and the broad sprint/milestone trigger introduces minor overlap risk with general planning skills.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Prioritize open issues", "Classifies backlog items across outcome altitude (Impact/Outcome vs Output vs Activity)", "evaluates them against repository strategic goals (P0 Strategic Drivers down to P4 Distractions)" — with a full taxonomy. Not a 5 because capabilities covered in the body (stale-item detection, semantic dedup, JSON output) are absent, leaving minor coverage gaps; not a 3 because it goes well beyond 1-2 actions.

4 / 5

Completeness

It explicitly answers both: what ("Prioritize open issues... Classifies backlog items... evaluates them against repository strategic goals") and when ("Use when planning milestones or sprints, triaging an issue backlog, deciding what work to pull next, or auditing a repository queue for outcome and strategic focus"). The 'when' is explicit with four concrete trigger phrases, matching the top anchor rather than the 'could be more explicit' level 4.

5 / 5

Trigger Term Quality

Natural phrases a user would say are present: "planning milestones or sprints", "triaging an issue backlog", "deciding what work to pull next", "auditing a repository queue". Not a 5 because common variations like "backlog grooming", "issue triage", or "what to work on next" are missing; not a 3 because keyword coverage is good with multiple natural trigger phrases.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche — prioritizing GitHub issue backlogs by outcome framing and goal alignment — with triggers specific to backlog triage. Not a 5 because "planning milestones or sprints" is a fairly broad trigger with some overlap risk against general sprint-planning or agile skills; not a 3 because the domain and trigger set are largely distinct.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 7 missing

Warning

Total

14

/

16

Passed

Repository

yyeret/ai-impact

Path

skills/prioritize-repo-issues/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.