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

Manifest Generator — скилл для Claude Code

Скилл Manifest Generator для Claude Code собирает YAML-манифест возможностей скилла или MCP-сервера: условия запуска, эффекты, домены и риски. Создаёт карточки для оркестратора по готовым описаниям.

MIT 131 установок ★ 39 обновлён 2025-12-25

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

Что делает Manifest Generator

Скилл читает описание ресурса и, если он есть, код: head -100 от index.js. Запись из META/skill-registry.json достаёт через jq. Дальше всё уходит в codex exec с промптом, который просит вернуть YAML-манифест по схеме. В манифесте — предусловия в виде проверок (file_exists('package.json'), has_dependency('react'), env_var_set('OPENAI_API_KEY')), эффекты глаголами вроде creates_vector_index, домены, блок совместимости с requires, conflicts_with, composes_with, enables, а ещё cost, latency и risk_level.

Перед записью файл проверяется через npx ajv по SCHEMAS/capability-manifest.schema.json и копируется в output_path. По умолчанию это каталог самого скилла.

Всё держится на выводе из описания. Куцый SKILL.md даст такие же куцые предусловия. А без команды codex в PATH шаг генерации не выполнится.

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

  • собрать манифест для нового скилла, не заполняя YAML руками
  • перегенерировать манифест после правки описания
  • найти расхождения между сохранённым манифестом и текущим описанием
  • вытащить предусловия и побочные эффекты из готового SKILL.md
  • проставить cost, latency и risk_level описанию MCP-сервера

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

  • Сгенерируй манифест для скилла в SKILLS/rag-implementer: читай SKILL.md, результат положи в manifest.yaml рядом.
  • Перегенерируй манифест для MCP-сервера pinecone-mcp и покажи, что изменилось против текущего.
  • Проверь сгенерированный manifest.yaml по SCHEMAS/capability-manifest.schema.json и почини то, что не проходит.

Как установить Manifest Generator

1Через Skills CLI (Vercel)

npx skills add daffy0208/ai-dev-standards --skill manifest-generator -a claude-code

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

~/.claude/skills/manifest-generator/SKILL.md

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

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

Вопросы о Manifest Generator

Как установить Manifest Generator в Claude Code?

Выполните npx skills add daffy0208/ai-dev-standards --skill manifest-generator -a claude-code. Файл скилла появится по пути ~/.claude/skills/manifest-generator/SKILL.md.

Что делает Manifest Generator?

Берёт описание скилла, MCP-сервера, инструмента или компонента и просит codex exec вывести по нему манифест возможностей: что должно существовать до запуска, что ресурс меняет, какие домены затрагивает и насколько он рискован. Перед сохранением YAML сверяется со схемой.

Что нужно, чтобы скилл сработал?

Команда codex для шага генерации, jq для чтения META/skill-registry.json и npx ajv вместе с SCHEMAS/capability-manifest.schema.json для проверки результата.

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

SKILL.md · MIT
---
name: Manifest Generator
description: Auto-generate capability manifests from skill/MCP descriptions using Codex-powered semantic analysis and structured extraction.
version: 1.0.0
category: ai-native
tags:
  - codex
  - automation
  - manifest
---

# Manifest Generator

**Auto-generate capability manifests from skill/MCP descriptions using Codex**

## Purpose

Uses OpenAI Codex to analyze existing skills, MCPs, tools, and components to automatically generate their capability manifests. This bootstraps the entire orchestration system by inferring preconditions, effects, domains, and relationships from descriptions and implementations.

## When to Use

- Bootstrapping: Generate manifests for all 59 skills + 50 MCPs at once
- New resources: Auto-generate manifest when creating new skills/MCPs
- Updates: Regenerate manifest when skill description changes
- Validation: Compare generated manifest with existing to detect drift

## Key Capabilities

- **Precondition Inference**: Analyzes skill description to determine what must exist before use
- **Effect Extraction**: Identifies state changes the skill produces
- **Domain Detection**: Categorizes skill into technical domains
- **Relationship Discovery**: Infers which skills this enables/conflicts with/composes with
- **Risk Assessment**: Evaluates cost, latency, and risk level from description

## Inputs

```yaml
inputs:
  skill_path: string # Path to skill directory (e.g., SKILLS/rag-implementer)
  resource_type: string # "skill" | "mcp" | "tool" | "component" | "integration"
  description_file: string # Usually SKILL.md or README.md
  implementation_file: string # Optional: actual code file for validation
  output_path: string # Where to write manifest.yaml (default: same directory)
```

## Process

### Step 1: Read Source Materials

```bash
# Read skill description
DESCRIPTION=$(cat $skill_path/SKILL.md)

# Read implementation if available
if [ -f "$skill_path/index.js" ]; then
  IMPLEMENTATION=$(head -100 $skill_path/index.js)
fi

# Read existing registry entry
REGISTRY_ENTRY=$(jq ".[] | select(.name==\"$skill_name\")" META/skill-registry.json)
```

### Step 2: Generate Manifest with Codex

```bash
codex exec "
Analyze this ${resource_type} and generate a capability manifest.

DESCRIPTION:
${DESCRIPTION}

IMPLEMENTATION (if available):
${IMPLEMENTATION}

REGISTRY ENTRY:
${REGISTRY_ENTRY}

Generate a YAML manifest matching this schema:
$(cat SCHEMAS/capability-manifest.schema.json)

Infer the following:

1. PRECONDITIONS: What files, dependencies, or state must exist?
   Examples:
   - file_exists('package.json')
   - has_dependency('react')
   - env_var_set('OPENAI_API_KEY')
   - not file_exists('.vector-index')

2. EFFECTS: What does this create/modify/delete?
   Examples:
   - creates_vector_index
   - adds_auth_middleware
   - configures_database
   - updates_tests

3. DOMAINS: What technical areas does it touch?
   Examples: rag, auth, api, database, testing, nextjs, react

4. COMPATIBILITY:
   - requires: What must exist first?
   - conflicts_with: What can't coexist?
   - composes_with: What works well together?
   - enables: What does this unlock?

5. RISK ASSESSMENT:
   - cost: free/low/medium/high (API calls, compute)
   - latency: instant/fast/slow (execution time)
   - risk_level: safe/low/medium/high (side effects)

6. SUCCESS SIGNAL: How do we know it worked?
   Examples:
   - 'tests pass'
   - 'file exists: .vector-index'
   - 'HTTP 200 from /api/search'
   - 'can query vector database'

Output ONLY valid YAML. No explanatory text.
"
```

### Step 3: Validate and Write

```bash
# Validate generated YAML against schema
npx ajv validate \
  -s SCHEMAS/capability-manifest.schema.json \
  -d /tmp/generated-manifest.yaml

# Write to output location
cp /tmp/generated-manifest.yaml $output_path
```

## Codex Prompt Template

```
Analyze this ${kind} and extract capability information:

NAME: ${name}
DESCRIPTION:
${description}

${implementation ? "IMPLEMENTATION:\n" + implementation : ""}

Generate a capability manifest with:

1. PRECONDITIONS (what must be true to use this?):
   - File checks: file_exists('path'), not file_exists('path')
   - Dependency checks: has_dependency('package-name')
   - Env checks: env_var_set('VAR_NAME')
   - State checks: describe project state requirements

2. EFFECTS (what changes does it make?):
   - Use imperative verbs: creates_, adds_, configures_, updates_, removes_
   - Be specific: "creates_vector_index", not "does vector stuff"

3. DOMAINS (what technical areas?):
   - Choose from: rag, auth, api, database, testing, nextjs, react, security, performance, etc.

4. COMPATIBILITY:
   - requires: [list of required capabilities]
   - conflicts_with: [capabilities that can't coexist]
   - composes_with: [capabilities that work well together]
   - enables: [capabilities this unlocks]

5. COST/LATENCY/RISK:
   - cost: free (no API calls), low (< $0.10), medium (< $1), high (> $1)
   - latency: instant (< 1s), fast (< 10s), slow (> 10s)
   - risk_level: safe (no side effects), low (idempotent), medium (modifies files), high (irreversible changes)

6. SUCCESS_SIGNAL: What confirms it worked?

Output as YAML matching capability-manifest schema.
```

## Example Output

```yaml
# SKILLS/rag-implementer/manifest.yaml
name: rag-implementer
kind: skill
description: Implement retrieval-augmented generation systems with vector databases and embedding pipelines
preconditions:
  - check: file_exists('package.json')
    description: Node.js project with package.json
    required: true
  - check: not file_exists('.vector-index')
    description: Vector database not already configured
    required: false
  - check: env_var_set('OPENAI_API_KEY') or env_var_set('ANTHROPIC_API_KEY')
    description: LLM API key for embeddings
    required: true
effects:
  - creates_vector_index
  - adds_embedding_pipeline
  - configures_retrieval_api
  - adds_rag_tests
domains:
  - rag
  - ai
  - search
  - embeddings
  - api
cost: medium
latency: slow
risk_level: low
side_effects:
  - modifies_files
  - makes_api_calls
idempotent: false
success_signal: 'Vector index created and queryable with test embeddings'
failure_signals:
  - 'API key invalid'
  - 'Vector database connection failed'
  - 'Embedding generation failed'
compatibility:
  requires:
    - openai-integration OR anthropic-integration
  conflicts_with:
    - existing-vector-database
  composes_with:
    - pinecone-mcp
    - weaviate-mcp
    - embedding-generator-mcp
  enables:
    - semantic-search
    - document-qa
    - knowledge-retrieval
observability:
  logs:
    - 'Embedding X documents'
    - 'Vector index created with Y dimensions'
    - 'Retrieval query: {query} returned {count} results'
  metrics:
    - embedding_count
    - retrieval_latency_ms
    - search_relevance_score
metadata:
  version: '1.0.0'
  created_at: '2025-10-28'
  tags:
    - rag
    - vector-database
    - embeddings
    - semantic-search
  examples:
    - 'Implement RAG for Next.js documentation site'
    - 'Add semantic search to existing API'
    - 'Build document Q&A system'
```

## Bootstrap Script

Run this to generate manifests for ALL resources:

```bash
#!/bin/bash
# scripts/bootstrap-manifests.sh

echo "Generating manifests for all skills..."
for skill_dir in SKILLS/*/; do
  skill_name=$(basename "$skill_dir")
  echo "  Processing $skill_name..."

  # Use manifest-generator skill
  bash scripts/skills/manifest-generator.sh \
    --path "$skill_dir" \
    --type "skill" \
    --description "$skill_dir/SKILL.md" \
    --output "$skill_dir/manifest.yaml"
done

echo "\nGenerating manifests for all MCPs..."
for mcp_dir in MCP-SERVERS/*/; do
  mcp_name=$(basename "$mcp_dir")
  echo "  Processing $mcp_name..."

  bash scripts/skills/manifest-generator.sh \
    --path "$mcp_dir" \
    --type "mcp" \
    --description "$mcp_dir/README.md" \
    --implementation "$mcp_dir/index.js" \
    --output "$mcp_dir/manifest.yaml"
done

echo "\nDone! Generated $(find SKILLS MCP-SERVERS -name 'manifest.yaml' | wc -l) manifests"
```

## Benefits

1. **Speed**: Generate 109 manifests in minutes instead of weeks
2. **Consistency**: Uniform format and completeness
3. **Discovery**: Codex finds relationships humans miss
4. **Validation**: Compare to detect description/implementation drift
5. **Evolution**: Re-run to update as skills change

## Integration

### With capability-graph-builder

Manifests become nodes in the capability graph. Relationships inferred from compatibility fields.

### With orchestration-planner

Planner queries manifests to find capabilities matching goal requirements.

### With skill-validator

Validator compares generated manifest with actual implementation to find discrepancies.

## Success Metrics

- ✅ 100% of skills/MCPs have manifests
- ✅ All manifests validate against schema
- ✅ Preconditions cover 90%+ of actual requirements
- ✅ Effects accurately describe state changes
- ✅ Relationship inferences 80%+ accurate

## Related Skills

- capability-graph-builder: Consumes manifests to build graph
- skill-validator: Validates manifests match implementations
- orchestration-planner: Uses manifests for planning

© daffy0208 · MIT · daffy0208/ai-dev-standards

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
edit-manifest chrono-meta Скилл edit-manifest для Claude Code, который замыкает цикл правок в харнессе: каждое изменение SKILL.md, правил или CLAUDE.md записывается с прогнозом эффекта, а следующая сессия сверяет прогноз с результатом. CX Codex +1 ★ 33звёзд репо manifest-yaml-cursorrules-prompt-file PatrickJS Правило manifest-yaml-cursorrules-prompt-file для Cursor, которое настраивает ассистента на создание бэкенда Manifest в YAML. Включается при генерации демо-приложений с сущностями и связями. CX Codex +1 ★ 41 178звёзд репо feature-manifest curiositech Скилл feature-manifest для Claude Code создаёт и проверяет манифесты фич, связывает фичи с кодом и обновляет changelog. Отслеживает, какой код относится к каждой фиче. CX Codex +1 181установок platform-manifest-generate forcedotcom Скилл platform-manifest-generate для Claude Code собирает package.xml и destructive-манифесты Salesforce из папки с метаданными, списка компонентов или орги. Создаёт манифесты для деплоя. CX Codex +1 3 300установок generate-ppmplugin-manifest Microsoft Скилл generate-ppmplugin-manifest проверяет и подготавливает manifest.json для бандла .ppmplugin перед сборкой. Помогает отловить ошибки имён и методов до запуска компиляции нативного кода. CX Codex +1 ★ 1 167звёзд репо pcf-manifest-schema официальный github Правило pcf-manifest-schema для GitHub Copilot подсказывает структуру ControlManifest.Input.xml: элементы, атрибуты и их назначение. Помогает при редактировании манифеста PCF-компонента. CX Codex +1 ★ 41 430звёзд репо

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

Весь набор →
System Diagnostician Скилл System Diagnostician запускает системную диагностику репозитория, находит пробелы в тестах и архитектуре, а затем ранжирует задачи по их полезности и сложности. CX Codex +1 138установок Framework Orchestrator Скилл Framework Orchestrator распределяет фреймворки и другие скиллы по этапам проекта. Он помогает выбрать сценарий работы и проверить переходы между фазами. CX Codex +1 136установок release-manager Скилл release-manager раскладывает выкатку фичи на фазы: сначала внутренняя команда, потом 5% бета-пользователей, дальше все. С фича-флагами, canary-деплоем и планом откатa. CX Codex +1 135установок Orchestration Planner Скилл Orchestration Planner раскладывает крупную цель на цепочку задач, проверяет возможности проекта и предлагает основной план с альтернативами. CX Codex +1 134установок Skill Validator Скилл Skill Validator сверяет реализацию скилла или MCP с манифестом через Codex. Находит расхождения в описаниях, пропущенные предусловия и нереализованные функции. CX Codex +1 131установок Capability Graph Builder Скилл Capability Graph Builder строит поисковый граф возможностей из манифестов инструментов и проверяет связи через Codex. Пригодится при сборке базы знаний для оркестрации агентов. CX Codex +1 130установок Archon Manager Скилл Archon Manager для Claude Code и Codex, который управляет проектами, отслеживает задачи и ищет по базе знаний на нескольких платформах. CX Codex +1 129установок Dark Matter Analyzer Скилл Dark Matter Analyzer диагностирует неявные проблемы репозитория: отрыв документации от кода, подавление линтеров и скрытый техдолг. Помогает понять, почему проект теряет управляемость. CX Codex +1 128установок

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

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