← Все навыки

skill issue

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.

Каталог из GitHub · что мы проверяем

Собираем навыки из Agentic Awesome Skills на GitHub. Это работы авторов сообщества, а не собственные разработки КОМЭКСПО. В карточках сохраняем источник и фиксированную версию.

Автоматические проверки

При импорте: проверяем адреса источников и убираем повторяющиеся идентификаторы. Некоторые категории риска исключаем.
При загрузке инструкции: проверяем формат SKILL.md, кодировку и объём. Ищем упоминания дополнительных файлов и инструментов.
Сверяем обозначение лицензии с разрешённым списком и учитываем известные исключения источника. Непонятные условия требуют отдельной проверки.

«Требует проверки» означает, что инструкция ещё не загружена и не проверена. Статусы совместимости не подтверждают безопасность, качество ответа или работу во всех моделях. Полный аудит кода, прав и тестирование каждого навыка не проводились. Скрипты не запускаем.

Авторы и условия использования

Оригинальные тексты коллекции заявлены под CC BY 4.0; у сторонних материалов могут быть другие условия. Открытый GitHub не означает отсутствие авторских прав. Сохраняйте авторство, ссылку на лицензию и отметки об изменениях.

Русские пояснения и промпт-обёртки подготовлены КОМЭКСПО. Оригинальные инструкции не переведены. Мы не связаны с GitHub или авторами навыков и не заявляем об их одобрении сервиса. Правообладателям: контакты — укажите карточку, оригинал и суть обращения.

Использовать навык

Без регистрации

Вставьте в свой ИИ-чат и замените последнюю строку своей задачей. Это инструкция, а не подключение новых инструментов.

Промпт для ИИ

Помоги выполнить мою задачу с опорой на навык «skill issue». Применяй только уместные инструкции. Не выдумывай факты и результаты действий. Если не хватает инструментов или данных — скажи об этом. Не запускай код и не передавай данные без моего поручения.

Источник: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/skill-issue/SKILL.md. Лицензия: MIT.

---
id: skill-issue
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."
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]
license: "MIT"
license_source: "https://github.com/mishanefedov/skill-issue/blob/main/LICENSE"
---

# 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.


Моя задача: [опишите задачу и приложите исходные материалы]

Agentic Awesome Skills — sickn33 и авторы коллекции. Описание автора; оригинальная инструкция без изменений. Авторство, исключения и лицензии: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
Оригинал: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/skill-issue/SKILL.md
Лицензия: MIT — https://opensource.org/license/mit
Авторство и исключения: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
SKILL.md сохранён без изменений. Промпт-обёртка и русские пояснения добавлены КОМЭКСПО. Сохраняйте уведомления авторов и условия лицензии при распространении. Авторы не заявляли об одобрении нашего сервиса. Материал предоставляется без гарантий.

Промпт попросит код-агента изучить фиксированную версию и предложить подключение к вашему проекту. Изменения требуют вашего согласования.

Промпт код-агенту

Подготовь подключение навыка «skill issue» к этому проекту. Сначала прочитай SKILL.md по фиксированной ссылке: https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/465ad05638fbe1d9e7f98671393396b6d9246393/skills/skill-issue/SKILL.md. Версия: 465ad05638fbe1d9e7f98671393396b6d9246393. SHA-256 файла: ce529aa76ffed985961c6d69088c7a9117f5ebeaa8ff5fcd9e16177ebc32c6cd. Лицензия: MIT. Проверь назначение, ограничения и доступные инструменты. Покажи, куда этот агент ожидает устанавливать навыки, и предложи точный план. Не перезаписывай существующие инструкции, не устанавливай зависимости, не запускай сторонние скрипты и не меняй права без отдельного согласования. Если инструкция ссылается на другие файлы, сообщи, какие отсутствуют. Моя задача: [опишите задачу].

Agentic Awesome Skills — sickn33 и авторы коллекции. Описание автора; оригинальная инструкция без изменений. Авторство, исключения и лицензии: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
Оригинал: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/skill-issue/SKILL.md
Лицензия: MIT — https://opensource.org/license/mit
Авторство и исключения: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
SKILL.md сохранён без изменений. Промпт-обёртка и русские пояснения добавлены КОМЭКСПО. Сохраняйте уведомления авторов и условия лицензии при распространении. Авторы не заявляли об одобрении нашего сервиса. Материал предоставляется без гарантий.

Скачать SKILL.md ↓

Источник: sickn33/agentic-awesome-skills · MIT · Оригинал ↗

Атрибуция для копирования и распространения

Авторство и лицензия

Agentic Awesome Skills — sickn33 и авторы коллекции. Описание автора; оригинальная инструкция без изменений. Авторство, исключения и лицензии: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
Оригинал: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/skills/skill-issue/SKILL.md
Лицензия: MIT — https://opensource.org/license/mit
Авторство и исключения: https://github.com/sickn33/agentic-awesome-skills/blob/465ad05638fbe1d9e7f98671393396b6d9246393/docs/sources/sources.md
SKILL.md сохранён без изменений. Промпт-обёртка и русские пояснения добавлены КОМЭКСПО. Сохраняйте уведомления авторов и условия лицензии при распространении. Авторы не заявляли об одобрении нашего сервиса. Материал предоставляется без гарантий.

Если распространяете скачанный файл, приложите атрибуцию и требуемые лицензией уведомления автора. При изменении инструкции укажите свои изменения. Условия лицензии

Как это работает

Навык задаёт подход к задаче: например, как редактировать текст или проверять код. Вы выбираете его в чате — ИИ получает эту инструкцию вместе с вашим запросом.

Поддерживаются текст, код и создание сайтов. Навык не подключает новые модели, терминал, MCP или аккаунты. Для изображений и видео используются отдельные инструменты.

Совместимость: Нужны доп. инструменты
Источник: sickn33/agentic-awesome-skills ↗
Версия: 465ad05638fb · фиксируется при добавлении
Лицензия: MIT
Звёзды репозитория: 47 140

Ограничения оригинала

В оригинале есть ссылки на файлы или внешние инструменты. Они не устанавливаются; в чате применяются только инструкции SKILL.md.

Оригинальная инструкция SKILL.md · 3 026 символов

---
id: skill-issue
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."
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]
license: "MIT"
license_source: "https://github.com/mishanefedov/skill-issue/blob/main/LICENSE"
---

# 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.

Личный кабинет

Другие возможности