CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

file-github-issue

Use when creating, categorizing, re-scoping, or sweeping GitHub issues on Alethical's Roadmap board (org `alethical-org` Project

Quality

84%

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

67%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 a well-structured, highly actionable operational guide with a clear two-step workflow and a self-healing sweep as a validation backstop. Its main weaknesses are inlined date-stamped history that pads the text, and the absence of an executable example for the central GraphQL board-field write.

Suggestions

Move date-stamped history (the July 2026 consolidation, the Jul 26 2026 'Candidates' rename, the verified 2026-07-26 remote-session finding, and the #416/#646/#647 incident references) into a short 'History / deprecated patterns' section at the end, or trim them, so the operational rules stay lean.

Tighten the Epic bullet by shortening the aside about `updateProjectV2Field` renaming and grouped-view rearrangement to one sentence, since the always-loaded rule 4 already covers the prohibition.

Add a minimal executable `gh api graphql` example for the step-two board-field write (fetch field/option IDs + `updateProjectV2ItemFieldValue`), since that is the skill's core operation and currently only named, never shown.

DimensionReasoningScore

Conciseness

Mostly efficient org-specific deltas, but date-stamped provenance is inlined rather than quarantined — "the July 2026 consolidation retired the old `v0`/`post-v0` scope labels", "(Jul 26 2026…)", "(verified 2026-07-26 while filing #646/#647)", "this is how #416 slipped in" — plus a long aside about `updateProjectV2Field` renaming and grouped views. Not 4 because these are several trimmable instances of time-sensitive/over-explanatory material, exceeding 'minor' over-explanation.

3 / 5

Actionability

Gives a copy-paste-ready sweep pipeline (`gh project item-list 1 --owner alethical-org --format json --limit 200 | jq …`), exact flags (`--label`, `--milestone`), named GraphQL mutations (`updateProjectV2ItemFieldValue`, `addProjectV2ItemById`, `addSubIssue`), and a spot-check command (`gh issue list --json number,issueType`). Not 5 because the core step-two board-field write is described ("query the project's field/option IDs with `gh api graphql`") but never shown as an executable example.

4 / 5

Workflow Clarity

The create-then-set-board-fields sequence is explicit with a clear failure tell ("An issue that lands in 'No Epic' or with a blank Priority/LOE/Type"), a self-healing validation backstop ("run the sweep and fix whatever it lists"), and a lifecycle checklist. Not 5 because the GraphQL half lacks an explicit validate→fix→retry checkpoint; its verification is implicit in the sweep.

4 / 5

Progressive Disclosure

Well-organized headed sections, one-level-deep external pointer (`.claude/rules/workflow.md`), no nested references, and no bundle files to misplace. Not 5 because the ~60-line body exceeds the under-50-line simple-skill bar and inlines the dense 8-axis reference material that could live in a `references/` file.

4 / 5

Total

15

/

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.

The description is specific, explicitly states both what the skill covers and when to invoke it, and is firmly scoped to a single org's board, minimizing conflict risk. Its only weakness is moderate density — natural trigger synonyms like "triage" or "project board" are absent.

DimensionReasoningScore

Specificity

Lists multiple concrete capabilities — "creating, categorizing, re-scoping, or sweeping GitHub issues", "the full 8-axis scheme (Type, Milestone, Epic, Platform Track, Priority, LOE, topic labels, Status)", "the two-step create-then-set-board-fields gotcha", "the uncategorized-item sweep command", and "the keep-the-board-current lifecycle rules" — comprehensively covering the skill's scope. Not 4 because there are no meaningful coverage gaps.

5 / 5

Completeness

Explicitly answers both: what (the 8-axis scheme, two-step gotcha, sweep command, lifecycle rules) and when ("Use when creating, categorizing, re-scoping, or sweeping GitHub issues…" and "Invoke before `gh issue create`, when moving an issue's Status, or when starting a session and sweeping the board"). Not 4 because the when-clause is explicit with concrete triggers, not merely present.

5 / 5

Trigger Term Quality

Good natural keywords users would say: "GitHub issues", "gh issue create", "moving an issue's Status", "sweeping the board", "starting a session". Not 5 because common variations such as "file an issue", "triage", or "project board" are missing.

4 / 5

Distinctiveness Conflict Risk

Pinned to a specific niche — "Alethical's Roadmap board (org `alethical-org` Project #1)" — with distinct triggers, so it is unlikely to fire for any unrelated skill. Not 4 because there is no realistic overlap with generic issue/labeling skills given the org-specific scoping.

5 / 5

Total

19

/

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

alethical-org/alethical

Path

.claude/skills/file-github-issue/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.