К основному содержанию
команда CX Codex

devkit.verify-skill — слэш-команда для Claude Code: проверка скилла

Команда devkit.verify-skill проверяет скилл по требованиям DevKit, структуре шаблона и зависимостям. Запустите команду перед публикацией или после изменений.

MIT ★ 372 обновлён 2026-09-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit@developer-kit
Открыть на GitHub

Что делает devkit.verify-skill

Команда ищет каталог скилла в проекте и пользовательской директории, затем проверяет наличие SKILL.md, его метаданные, структуру и ссылки на файлы. Также она сверяет разделы с шаблоном DevKit и проверяет зависимости, если в скилле упомянуты конкретные библиотеки или фреймворки.

Для проверки зависимостей команда использует Context7, а если он недоступен — u2m. Ошибка u2m не проваливает проверку. Результат — отчёт об успешной проверке или список проблем по категориям. Укажите имя скилла аргументом: без него команда не знает, что искать.

Какие задачи решает

  • проверить наличие SKILL.md в каталоге скилла
  • найти ошибки во frontmatter и структуре файла
  • сверить разделы с шаблоном DevKit
  • проверить актуальность упомянутых библиотек
  • получить список проблем перед публикацией скилла

Примеры запросов агенту

  • Проверь скилл api-helper перед публикацией: /developer-kit:devkit.verify-skill api-helper.
  • Проверь react-review после изменений и перечисли ошибки по категориям: /developer-kit:devkit.verify-skill react-review.
  • Проверь зависимости скилла db-tools: /developer-kit:devkit.verify-skill db-tools.

Как установить devkit.verify-skill

1Через маркетплейс плагинов

/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit@developer-kit

2Вручную: положить файлы

.claude/commands/devkit.verify-skill.md

Вызов — /devkit.verify-skill. Для всех проектов — ~/.claude/commands/

Вопросы о devkit.verify-skill

Как установить devkit.verify-skill в Claude Code?

Выполните /plugin marketplace add giuseppe-trisciuoglio/developer-kit, затем /plugin install developer-kit@developer-kit. Команда находится в .claude/commands/devkit.verify-skill.md.

Что делает devkit.verify-skill?

Проверяет скилл по требованиям и шаблону DevKit: ищет SKILL.md, анализирует метаданные, разделы и ссылки. Для конкретных библиотек или фреймворков запускает проверку зависимостей.

Как команда проверяет зависимости скилла?

Она использует Context7, а если он недоступен — u2m. Ошибка u2m отмечается в результате, но сама по себе не считается провалом проверки.

Исходный текст

devkit.verify-skill.md · MIT
---
description: Validates a skill against DevKit standards (requirements, template, dependencies). Use when you need to verify a skill before publishing or after modifications.
argument-hint: "[skill-name]"
allowed-tools: Read, Grep, Glob
---

# Verify Skill: $1

## Overview

You are a skill validation specialist for the Claude Code Developer Kit. Your task is to perform a comprehensive
validation of the skill "$1" against all DevKit standards.

## Usage

```
/devkit.verify-skill $ARGUMENTS
```

## Arguments

| Argument     | Description                              |
|--------------|------------------------------------------|
| `$ARGUMENTS` | Combined arguments passed to the command |

## Execution Instructions

**Agent Selection**: To execute this task, use the following approach:

- Primary: Use `general-purpose` agent with appropriate domain expertise
- Or use specialized agent if available for the specific task type

## Validation Process

Execute the following checks in sequence:

### 1. Skill Existence Check

- Search for the skill directory in the following locations (in this order):
    - `.claude/skills/$1/` (project-level)
    - `~/.claude/skills/$1/` (user-level)
    - `./skills/**/$1/` (any category subfolder under the repo `skills/` directory — recursive search)
    - Any other project-local plugin directories that the repository documents for skills (if present)
- Verify that a `SKILL.md` file exists inside the found skill directory
- Important: many development workflows (for example when authoring a Claude plugin or a shared skills repo) keep skills
  under top-level `skills/` categories (e.g. `skills/langchain4j/<skill-name>`). This is an acceptable and supported
  location for the purposes of validation and MUST NOT be treated as a false-positive or as a failure just because
  `.claude/skills/` or `~/.claude/skills/` do not contain the skill.
- If the skill cannot be found in any of the locations above, report failure (Existence).

### 2. Requirements Conformance (@.docs/skills.md)

Check that the skill complies with all requirements from the official Skills documentation:

**SKILL.md Frontmatter:**

- `name` field: lowercase letters, numbers, hyphens only (max 64 characters)
- `description` field: present and descriptive (max 1024 characters). Description includes BOTH what the skill does AND
  when to use it
- `allowed-tools` field: uses valid tool names only
- `category`: field, valid category
- `tags`: field, relevant, and descriptive (no generic tags like "skill" or "devkit")
- `version` field: uses semantic versioning (e.g., 1.0.0)
  **Important:** Other frontmatter fields are not allowed.

**File Structure:**

- `SKILL.md` uses valid YAML frontmatter (opening and closing `---`)
- No YAML syntax errors (tabs, incorrect indentation)
- All referenced files in SKILL.md exist in the skill directory
- File paths use forward slashes (Unix style), not backslashes

**Content Quality:**

- Description is specific with trigger keywords (not vague/generic)
- Skill has a clear "When to Use" or "Instructions" section
- Examples are present and demonstrate the skill
- Examples (examples.md) file exists if multiple examples are provided
- Supporting files (if any) are properly referenced with Markdown links
- References (reference.md) file exists if the skill is complex

### 3. Template Adherence (@.docs/skill_template.md)

Verify the skill structure matches the template:

**Required Sections:**

- Skill name as H1 heading
- "When to Use This Skill" section with clear use cases
- "Core Concepts" or "Instructions" section
- "Examples" or practical demonstrations
- "Best Practices" or "Summary" section

**Metadata Alignment:**

- Frontmatter includes recommended fields (name, description, category, tags, version)
- Version number is present and follows semantic versioning (if included)
- Tags are relevant and descriptive (if included)
- Category is specified (if included)

**Content Organization:**

- Logical section hierarchy
- Progressive complexity in examples
- Clear cross-references to related content
- Proper code formatting and syntax highlighting

### 4. Dependency Validation (Context7 or u2m)

**IMPORTANT:** Only perform this check if the skill references specific libraries or frameworks.

For each library/framework mentioned in the skill:

- Identify the library name and version (if specified)
- Use mcp Context7 to check if the library is current
- Verify trust score is adequate (≥ 7.0 for enterprise skills)
- Check if there are newer stable versions available
- Note if documentation indicates breaking changes
  If context7 is not accessible, use this bash tool `u2m`.
- Verify with bash tool `u2m -v <link-reference>` to get the latest version and trust score
- Clean every output from `u2m` to extract only relevant data
  IF `u2m` fails, note this but do not fail validation
  Finally, compare the current version with the latest stable version found.

**Skip this check if:**

- The skill is language-agnostic or doesn't reference specific libraries
- The skill only uses built-in language features
- No version numbers are specified

## Output Format

### Success Case

If ALL checks pass, output:

```
✅ Validation completed: The skill '$1' complies with all standards.

Details:
- ✅ SKILL.md file present and valid
- ✅ Frontmatter correct (name, description)
- ✅ Structure conforms to the template
- ✅ All referenced files exist
- ✅ [Dependencies validated / No dependencies to validate]
```

### Failure Case

If ANY check fails, output:

```
❌ Validation failed for the skill '$1'.

Required actions:

* **[Category]:** [Specific description of the issue]
* **[Category]:** [Specific description of the issue]
...
```

**Categories for errors:**

- **Existence:** Skill or SKILL.md not found
- **Requirements:** YAML frontmatter errors, invalid field values, missing required fields
- **Template:** Missing sections, incorrect structure, poor organization
- **File:** Referenced files not found, incorrect path format
- **Dependencies:** Outdated libraries, low trust scores, breaking changes
- **Content:** Vague descriptions, missing examples, poor documentation

## Examples of Specific Feedback

**Good specific feedback:**

- ❌ **Requirements:** The `name` field contains uppercase characters. It must use only lowercase letters, numbers, and
  hyphens.
- ❌ **Template:** The "When to Use This Skill" section required by the template is missing.
- ❌ **File:** The `reference.md` file is referenced in SKILL.md but does not exist in the skill directory.
- ❌ **Dependencies:** The 'spring-boot' library uses version 2.7.x. Recommended version: 3.2.x (Context7 Trust Score:
  9.2).
- ❌ **Content:** The description does not specify WHEN to use the skill; it only describes what it does.

**Bad vague feedback (avoid):**

- ❌ The file is not valid
- ❌ There are issues with the template
- ❌ The dependencies might be outdated

## Validation Rules

1. **Be thorough:** Check every requirement systematically
2. **Be specific:** Each error must include the exact issue and how to fix it
3. **Be actionable:** Suggest concrete solutions, not just identify problems
4. **Be accurate:** Only report actual issues found, don't assume
5. **Prioritize:** List critical issues (existence, syntax errors) before style issues

## Additional Notes

- If the skill directory exists but is empty, report as missing SKILL.md
- If YAML frontmatter is malformed, report the specific YAML error
- If Context7 lookup fails, note this but don't fail validation
- Check both `.claude/skills/$1/` (project) and `~/.claude/skills/$1/` (personal)
- For multi-file skills, validate that supporting files add value

Begin validation now for skill: $1

---

## Examples

```bash
/devkit.verify-skill skill-name
```

© Giuseppe Trisciuoglio · MIT · giuseppe-trisciuoglio/developer-kit

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →
session-analyzer ai-native-camp Скилл session-analyzer проверяет завершённую сессию Claude Code по требованиям из SKILL.md: вызовы агентов и хуков, файлы и ошибки. Пригодится, чтобы выяснить, где выполнение разошлось с ожидаемым. CX Codex +1 1 300установок skill-tester borghei Скилл skill-tester для Claude Code проверяет пакеты скиллов, тестирует Python-скрипты и выставляет оценку. Запускается при создании, аудите или подготовке скилла к публикации. CX Codex +1 136установок skill-evaluator gotalab Скилл skill-evaluator проверяет качество скиллов для ИИ-агентов по рекомендациям Anthropic. Помогает найти ошибки в SKILL.md и составить план улучшений перед публикацией. CX Codex +1 ★ 423звёзд репо skill-check olgasafonova Скилл skill-check для Claude Code: прогоняет SKILL.md через проверки Anthropic и спецификации agentskills. Находит, где определение сломается. CX Codex +1 ★ 45звёзд репо jetson-init-target Jetson Team Скилл jetson-init-target создаёт YAML-профиль платформы NVIDIA Jetson и обновляет указатель активного таргета. Пригодится при первичной настройке devkit или кастомной платы. CX Codex +1 1 100установок hsb-setup Holoscan Team Скилл hsb-setup для Claude Code и пяти других платформ, который разворачивает среду NVIDIA Holoscan Sensor Bridge от клонирования репозитория до проверки связи с платой. CX Codex +1 1 700установок

Из того же набора191

Весь набор →
bug-fix-brief Собирает структурированный Bug Fix Brief: причина, шаги воспроизведения, варианты правки и чек-лист. Фиксирует решение до написания кода. CX Codex +1 3 200установок pr-review-comments Скилл pr-review-comments для Claude Code. Публикует замечания ревью из JSON-файла в виде построчных комментариев к пулл-реквесту на GitHub, привязывая выводы проверки к конкретным строкам в диффе. CX Codex +1 2 600установок nestjs-testing Правило nestjs-testing для NestJS-проектов: тестирует сервисы через TestingModule, мокирует зависимости Jest и пишет E2E-тесты с Supertest. Нужно, чтобы тесты не вызывали реальные API и БД. CX Codex +1 ★ 372звёзд репо nestjs-database-expert Субагент nestjs-database-expert для Claude Code помогает проектировать базы данных в NestJS: настраивает Drizzle ORM, генерирует миграции и пишет типизированные запросы. CX Codex ★ 372звёзд репо aws-cloudformation-dynamodb Скилл aws-cloudformation-dynamodb для Claude Code даёт шаблоны CloudFormation для таблиц DynamoDB: ключи, индексы, режимы ёмкости, TTL и стримы. Описывает инфраструктуру кодом. CX Codex +1 ★ 372звёзд репо devkit.java.write-unit-tests Команда devkit.java.write-unit-tests создаёт модульные тесты на JUnit 5, Mockito и AssertJ по пути к Java-классу. Пригодится при тестировании сервисов, контроллеров и утилит в Spring Boot. CX Codex +1 ★ 372звёзд репо clean-architecture Помогает проектировать слои Clean Architecture, DDD и Hexagonal Architecture в приложениях NestJS на TypeScript. Пригодится при создании доменной модели или разборе тесно связанного MVC-кода. CX Codex +1 ★ 372звёзд репо spring-boot-backend-development-expert Субагент spring-boot-backend-development-expert для Claude по бэкенду на Spring Boot: реализует фичи, раскладывает код по Clean Architecture и пишет тесты к тому, что сделал. CX Codex ★ 372звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой