Agent skill

Skill Issue

by sickn33 in sickn33/agentic-awesome-skills

Find out why a coding-agent skill won't fire — grade each SKILL.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another.

MITAuto-check passed

Install Skill Issue

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill skill-issue -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills skill-issue --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skill-issue .claude/skills/skill-issue && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
skill-issue
GitHub stars
47k
Used in
1 other repo
Token cost
~757 tokens
SKILL.md length
231 words
Files
1
Skills in repo
1,354
Repo updated
First seen
Licence
MIT

At a glance

Find out why a coding-agent skill won't fire — grade each SKILL.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another.

  • SKILL.md covers Overview, When to Use This Skill, How It Works and Examples, plus 1 more section
  • Calls npm, brew and npx

What it does

Skill Issue is an agent skill from sickn33/agentic-awesome-skills. Find out why a coding-agent skill won't fire — grade each SKILL.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another.

Its SKILL.md is about 760 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

Example prompts

  • “/skill-issue”

Requirements

  • Node.js

What it can do on your machine

Read from SKILL.md and the folder at commit ec02547. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • brew
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Skill Issue loads about 757 tokens when it runs. Until then it costs about 48 tokens; SKILL.md has 231 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~48
When it runs · the whole SKILL.md, loaded when a task matches
~757

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit ec02547, republished under its MIT licence (© sickn33). 231 words, ~757 tokens.

Download SKILL.mdSave it as .claude/skills/skill-issue/SKILL.md (or your agent's skills folder).
name
skill-issue
description
Find out why a coding-agent skill won't fire — grade each SKILL.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another.
id
skill-issue
category
meta
risk
safe
source
community
source_repo
mishanefedov/skill-issue
source_type
community
date_added
2026-06-02
author
mishanefedov
tags
skills, linter, activation, meta, ci
tools
claude, cursor, gemini, codex

skill-issue — skill activation audit

Overview

A coding agent decides which skill to run from each skill's always-on name + description. A skill can be perfectly implemented and still never fire because its description is too vague to match how people phrase requests, or because a more specific sibling silently wins. skill-issue audits exactly that surface, grading each skill A–F, simulating which skill fires for a given prompt, and reporting collision clusters where one skill shadows another.

When to Use This Skill

  • Use when a skill you wrote never seems to trigger and you don't know why
  • Use when the user says "why isn't my skill firing", "which skill fires for X", or "audit my skills"
  • Use after writing or installing a new SKILL.md, to confirm it will actually be picked
  • Use in CI to fail a PR that adds a skill with empty/duplicate/colliding metadata

How It Works

Install the CLI (npm i -g @misha_misha/skill-issue, brew install mishanefedov/skill-issue/skill-issue, or npx @misha_misha/skill-issue), then:

bash
skill-issue ~/.claude/skills                       # grade every skill A–F (+ collisions summary)
skill-issue ~/.codex/skills --why "deploy to prod" # which skill fires for this prompt, and why
skill-issue <dir> --collisions                     # clusters of skills that shadow each other
skill-issue <dir> --fix                            # append a "Use when …" clause to weak descriptions
skill-issue <dir> --json                           # machine-readable; exits non-zero on errors

Offline heuristic by default; add --llm to judge with a local claude/codex CLI.

Examples

Example 1: Audit installed skills
bash
skill-issue ~/.claude/skills
# F  deploy-helper  ✗ no description — can never fire
# C  shipit         ! no "use when …" trigger clause
# A  rollback-prod  ✓ will fire on its triggers
Example 2: Diagnose a collision
bash
skill-issue ~/.claude/skills --why "deploy the app to prod"
#  1. shipit       0.74  ← would fire
#  2. land-deploy  0.69  (margin 0.05 — ambiguous, likely collision)

Limitations

  • Offline scoring is heuristic and should be treated as a triage signal, not a final quality verdict.
  • Collision reports highlight likely shadowing, but agent-specific routers can weight metadata differently.
  • The --fix mode can improve weak trigger wording, but generated edits still need maintainer review before committing.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/skill-issue of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit ec02547

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Skill Issue next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Skill Issue compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skill Issue this skillsickn33/agentic-awesome-skills47k1 repos~757Automated safety check: PassMIT
Grade Iteratealirezarezvani/claude-skills28k—~1kAutomated safety check: PassMIT
Fire SkillsLeoYeAI/openclaw-master-skills2.2k—~5.1kAutomated safety check: PassMIT
Grade Testsdotnet/skills5.6k1 repos~5.2kAutomated safety check: PassMIT
Evidence Gradingmohitagw15856/pm-claude-skills1.4k—~1.5kAutomated safety check: PassMIT
Ops Firesdavepoon/buildwithclaude3.6k—~1.8kAutomated safety check: NotesMIT

Similar skills

  • Grade Iterate

    alirezarezvani/claude-skills

    Phase 3 of building a Claude Managed Agent — the bounded grade→iterate loop.

    28k GitHub stars~1k tokensUpdated 1 mo ago
    EducationAuto-check passed
  • Fire Skills

    LeoYeAI/openclaw-master-skills

    Practical fire building, management, and safety skills. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~5.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Grade Tests

    dotnet/skills

    Official

    Assess a curated list of tests and produce a PR-ready table with a primary Pass, Failed, Uncertain, or Not applicable result plus A-F quality detail for every resolved test; Uncertain and Not…

    5.6k GitHub starsUsed in 1 repo~5.2k tokens
    MobileAuto-check passed
  • Evidence Grading

    mohitagw15856/pm-claude-skills

    Grade the evidence behind a claim before betting on it — the hierarchy for business evidence (experiments usage data surveys interviews anecdotes opinion), the fit-for-decision test, and the…

    1.4k GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Ops Fires

    davepoon/buildwithclaude

    Production incidents dashboard. An agent skill from davepoon/buildwithclaude.

    3.6k GitHub stars~1.8k tokensUpdated 2 days ago
    Testing & QAAuto-check: notes
  • Ops Fires

    Lifecycle-Innovations-Limited/claude-ops

    OPS on-demand: This skill should be used when the user asks to "production fires", "what is on fire"…

    540 GitHub stars~3.7k tokensUpdated yesterday
    DevOps & CloudAuto-check: notes

More from sickn33/agentic-awesome-skills

All 1,354 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed
  • Content Creator

    sickn33/agentic-awesome-skills

    Drafts and reviews audience-specific content from supplied brand examples, with local scripts for brand voice and SEO diagnostics, channel templates and a content calendar.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed

Questions about Skill Issue

What does Skill Issue do?

Find out why a coding-agent skill won't fire — grade each SKILL.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another. Skill Issue is an agent skill from sickn33/agentic-awesome-skills.md A–F on activation, simulate which skill a prompt triggers, and flag collisions where one silently shadows another.

How do I install Skill Issue in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill skill-issue -a claude-code`. Or copy the skill folder (skills/skill-issue in sickn33/agentic-awesome-skills) into .claude/skills/skill-issue in your project. Claude Code loads it when a task matches its description.

How do I install Skill Issue in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill skill-issue -a codex`. Or copy the skill folder (skills/skill-issue in sickn33/agentic-awesome-skills) into .agents/skills/skill-issue in your project. Codex loads it when a task matches its description.

Can I use Skill Issue in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill skill-issue -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/skill-issue, .gemini/skills/skill-issue, .github/skills/skill-issue and .opencode/skills/skill-issue in your project.

What does Skill Issue need to run?

Going by SKILL.md and its folder, Skill Issue needs the command-line tools its instructions call (npm, brew and npx). Our summary lists: Node.js.

Does Skill Issue access the network?

SKILL.md contains no URLs. Its commands use npm and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Skill Issue safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Skill Issue use?

Skill Issue is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skill Issue use?

About 757 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Skill Issue?

Skills that share tags, products or a category with Skill Issue: Grade Iterate (alirezarezvani/claude-skills, 28k stars), Fire Skills (LeoYeAI/openclaw-master-skills, 2.2k stars), Grade Tests (dotnet/skills, 5.6k stars) and Evidence Grading (mohitagw15856/pm-claude-skills, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skill Issue?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,343 GitHub stars. The repository holds 1,354 skills in this directory. The repository was last updated on October 7, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.