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

skill-update — скилл для Claude Code: создание и валидация скиллов

Скилл skill-update генерирует структуру скилла, проверяет её по лучшим практикам Anthropic и блокирует файлы, превышающие лимиты строк. Используй при создании или обновлении скилла.

MIT 174 установок ★ 632 обновлён 2026-07-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add transilienceai/communitytools --skill skill-update -a claude-code
Открыть на GitHub

Что делает skill-update

skill-update автоматизирует весь цикл работы со скиллами: от генерации директории и YAML-фронтматера до валидации каждого файла. Скилл вводит жёсткие ограничения — SKILL.md не более 150 строк, reference/*.md не более 200, reference/scenarios/*.md не более 400. Линтер scripts/skill_linter.py проверяет каждый файл, следит, чтобы в ссылках не было сломанных путей, убирает осиротевшие документы и блокирует вредные паттерны типа DO NOT вне секции ## Anti-Patterns.

Внутри скилла четыре этапа: сбор знаний из проектов, переформулировка в переиспользуемые паттерны, четырёхступенчатая проверка (обобщаемость, ценность, отсутствие дубликатов, минимальный размер) и запись в базу. Все решения о промоции обучения и разрешении записи — чистый JavaScript в .claude/workflows/lib/wf-helpers.mjs, агент выбора не принимает.

Рабочий процесс запускается через Workflow('skill-update', ...) с параметрами: output_dir для сбора из проекта, learnings для оценки известного набора или mode: 'audit' для чтения без изменений. Добавь dryRun: true чтобы увидеть план записи без самой записи.

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

  • Генерировать структуру скилла с YAML-фронтматером и разделением на SKILL.md, reference/ и scenarios/
  • Валидировать файлы скилла против лимитов строк и проверять целостность ссылок
  • Переформулировать знания из проектов в обобщаемые паттерны без специфики целей
  • Отфильтровать дубликаты и слабые записи через четырёхступенчатую проверку
  • Убирать служебные файлы, осиротевшие документы и вредные паттерны из базы скиллов

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

  • Сгенерируй структуру нового скилла и добавь туда паттерны аутентификации из документации
  • Проверь скилл на нарушения лимитов строк и осиротевшие ссылки в reference/
  • Собери техники из завершённого проекта и переформулируй их как переиспользуемые паттерны для скилла

Как установить skill-update

1Через Skills CLI (Vercel)

npx skills add transilienceai/communitytools --skill skill-update -a claude-code

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

~/.claude/skills/skill-update/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/skill-update/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о skill-update

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

Выполни npx skills add transilienceai/communitytools --skill skill-update -a claude-code, затем открой ~/.claude/skills/skill-update/SKILL.md.

Что делает skill-update?

Скилл генерирует структуру файлов скилла, валидирует их по лимитам строк (SKILL.md ≤150, reference/*.md ≤200, scenarios/ ≤400), проверяет целостность ссылок и переформулирует знания в переиспользуемые паттерны через четырёхступенчатую проверку.

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

Используй Workflow('skill-update', { learnings: [{ text, technique_type }] }) или { output_dir: 'projects/<engagement>' } для сбора из папки проекта. Скилл автоматически проверит обобщаемость, ценность и размер перед добавлением в базу.

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

SKILL.md · MIT
---
name: skill-update
description: Skill creation, update and management — generates skill directory structure, validates against best practices, enforces line count limits. Use when creating, updating, or improving skills.
model: opus
---

# Skill Update

Generate or refine Claude Code skills following Anthropic best practices.

## Hard caps (enforced by `scripts/skill_linter.py`)

- `SKILL.md` ≤ 150 lines
- `reference/*.md` ≤ 200 lines (`reference/scenarios/*.md` ≤ 400 lines)
- `README.md` ≤ 100 lines
- Every `SKILL.md` has YAML frontmatter with `name` + `description`
- No `DO NOT` / `MUST NOT` / `NEVER` outside an `## Anti-Patterns` section
- No challenge-specific identifiers (machine names, lab IDs, lab IPs, preserved flags)
- Every Markdown link resolves to an existing file
- Every reference file is linked from at least one other file (no orphans)

## Principles

- **Brevity first.** Every file short, simple, human-readable. Challenge every token.
- **Progressive disclosure.** SKILL.md navigates; `reference/` holds detail; `reference/scenarios/` holds concrete exploit flows.
- **Separation of concern.** SKILL.md = WHAT + when. `reference/role-*.md` = HOW agents behave when spawned.
- **Single canonical home** for any cross-cutting rule (output discipline, credential loading, brute-force, etc.). Other files reference, never restate.

## File structure

```
skills/<skill-name>/
├── SKILL.md           # ≤150 lines, YAML + navigation
├── reference/
│   ├── *-principles.md  # ≤150 lines (decision tree)
│   ├── INDEX.md
│   ├── *.md             # patterns, ≤200 lines
│   └── scenarios/
│       └── <category>/
│           └── *.md     # ≤400 lines, self-contained
└── README.md          # optional, ≤100 lines
```

## SKILL.md template

```yaml
---
name: <skill-name>
description: What it does AND when to use. Include trigger phrases.
---

# <Skill Name>

<one-paragraph scope>

## When to use

- <bullet>

## Workflow / Quick start

<≤30 lines>

## References

- [reference/...](reference/...)

## Anti-Patterns

- <when negative framing is genuinely needed, put it here>
```

## Run it

The procedure is a workflow — every step is code-enforced, so none can be skipped.

```
Workflow('skill-update', { output_dir: 'projects/<engagement>' })   // harvest an engagement
Workflow('skill-update', { learnings: [{ text, technique_type }] }) // judge a known set
Workflow('skill-update', { mode: 'audit' })                         // read-only, writes nothing
```

Add `dryRun: true` to see the write plan without writing. Parent-orchestrator only.

**Phases.** Intake (baseline `skill_linter.py --json`) → Harvest (reframe learnings) →
Judge (four gates + blind refuters) → Route (author the block) → Write (persist verbatim) →
Sweep (confidentiality guard) → Verify (linter **delta**, not an absolute clean tree — the
base carries pre-existing violations).

Every promote/reject/write decision is pure JS in `.claude/workflows/lib/wf-helpers.mjs`
(`promotionGate`, `capBudget`, `writeGate`, `lintDelta`, `skillUpdateGate`). No agent decides
whether a learning is promoted or a write is allowed.

## The four-gate promotion test

Process the techniques and failure modes from completed engagements. Promote a learning to the skill base only if **all four** hold:

1. **Generalizable.** Reusable pattern, not target-specific lore. No machine names, lab IDs, target IPs, preserved flags, writeup attributions.
2. **Material improvement.** Adds coverage, efficiency, or decision-quality for future engagements.
3. **Not already captured** elsewhere in the skill base. (`scripts/skill_linter.py` flags duplicates.)
4. **Minimal footprint.** Prefer extending an existing entry over adding a new file. Keep the base lean and high-signal.

## Reframing recipe

Always frame as a reusable pattern: *"when encountering X condition, try Y approach"* — never *"on box-N, Y worked"*. Use `<TARGET_IP>`, `<DC_FQDN>`, `<DOMAIN>` placeholders in tool examples.

## Output

Three buckets, built in code so a run cannot claim an edit it did not make:
**Updated.** / **Skipped.** (with the gate that failed) / **No changes.**

## Reference

- [STRUCTURE.md](reference/STRUCTURE.md) — directory layout requirements.
- [FRONTMATTER.md](reference/FRONTMATTER.md) — YAML rules.
- [CONTENT.md](reference/CONTENT.md) — writing guidelines.
- [ROUTING.md](reference/ROUTING.md) — technique type → target file.

## Anti-Patterns

- Creating CHANGELOG.md / SUMMARY.md / VERIFICATION.md auxiliary files.
- Meta-documentation about the creation process inside the skill itself.
- Verbose inline templates and examples (link to `reference/` instead).
- Re-introducing duplicate rule prose (brute-force, output-dir, env-reader).
- Files past their cap — split into `reference/` immediately.

© transilienceai · MIT · transilienceai/communitytools

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
create-skill aeonfun Скилл create-skill берёт описание в одну строку и собирает из него готовый скилл: разбирает запрос, проверяет дубликаты, ищет документацию по API и открывает PR. CX Codex +1 ★ 797звёзд репо continuous-learning affaan-m Скилл continuous-learning для Claude Code оценивает завершённые диалоги и извлекает шаблоны решений. Хук сохраняет найденные правила в каталог learned skills. CX Codex +1 6 300установок update-installed-skills MoizIbnYousaf Скилл update-installed-skills для Claude Code синхронизирует установленные скиллы с новыми версиями в репозиториях. Перед синхронизацией проверяет обновления через dry-run; локальные правки нужно сохранить отдельно. CX Codex +1 168установок langgraph-human-in-the-loop langchain-ai Скилл langgraph-human-in-the-loop для Claude Code и других платформ: строит графы LangGraph с паузами, ждущими человеческого ввода, одобрения или валидации. CX Codex +1 18 300установок skill-idea-miner tradermonty Скилл skill-idea-miner для Claude Code ищет идеи новых скиллов в логах сессий. Еженедельный пайплайн оценивает кандидатов и добавляет их в бэклог. CX Codex +1 3 500установок skill-designer tradermonty Скилл skill-designer собирает из JSON-описания идеи готовый промпт, по которому Claude создаёт папку нового скилла со всеми файлами. CX Codex +1 3 500установок

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

Весь набор →
system Скилл system для тестирования безопасности на уровне системы: атаки на Active Directory, повышение привилегий в Linux и Windows, разработка эксплойтов. Пригодится пентестерам и исследователям безопасности. CX Codex +1 194установок firewall-review Скилл firewall-review для Claude Code помогает проверять конфигурации межсетевых экранов и готовить отчёт об аудите. Вызывается для разбора правил, включая проверки FortiGate. CX Codex +1 186установок cve-risk-score Скилл cve-risk-score ищет сведения о CVE в NVD и показывает оценку CVSS, уровень серьёзности, CWE и описание. Срабатывает, когда CVE ID появляется в разговоре. CX Codex +1 185установок script-generator Скилл script-generator генерирует готовые скрипты на Python, Bash и PowerShell с проверкой синтаксиса и защитой от зависания. Сам код агент никогда не запускает. CX Codex +1 176установок risk-prioritiser Скилл risk-prioritiser для Claude Code ранжирует подтверждённые цепочки атак по технической серьёзности, реализуемости и влиянию на бизнес. Запускается по расписанию после сборки графа атак и при появлении находки с nvd.score >= 9.0. CX Codex +1 168установок cryptography Скилл cryptography для Claude Code помогает проводить криптоанализ в CTF и пентестах: выявлять структуру шифров и применять профильные атаки. CX Codex +1 165установок skill-prune Скилл skill-prune для Claude Code находит осиротевшие, дублирующие и устаревшие записи в других скиллах. Используется для регулярной чистки базы знаний агента. CX Codex +1 163установок pentest-engagement Скилл pentest-engagement проводит пентест веб-приложений или сканирование сети по заданному скоупу, проверяет уязвимости и собирает отчёт в PDF. CX Codex +1 157установок

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

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