Инвентарь форматы

Skill Item

Жол:

skills/<name>.md

Мысал:

---
name: create-spec
description: Әзірлеуші үшін қысқаша ТЗ жазу
targets:
  - claude-code
  - cursor
tags:
  - planning
---

# Role

...

Өрістер:

Өріс	Міндетті	Сипаттама
name	иә	Дағды идентификаторы; файл атымен сәйкес болуы керек
description	жоқ	Дағдының қысқаша сипаттамасы
targets	жоқ	AI орталар тізімі; белгіленбесе, барлық анықталғандарға қолданылады
tags	жоқ	Пайдаланушы тегтері

Frontmatter кейінгі Markdown денесі бос болмауы керек.

Folder Skill

Skill Item қалта түрінде сақталуы мүмкін:

skills/<name>/SKILL.md
skills/<name>/agent-patterns.md   # қосымша анықтамалық файлдар
skills/<name>/delegation.md
skills/<name>/examples.md

SKILL.md — frontmatter мен денесі бар дағдының негізгі файлы. Қалтадағы қалған файлдар анықтамалық: оларды SKILL.md-де @mention арқылы атауға болады. Дағды орнатылған кезде бүкіл қалта AI ортасына көшіріледі.

Басымдық: skills/<name>.md және skills/<name>/SKILL.md бір мезгілде болса, жалпақ файл (<name>.md) қолданылады.

Шектеу: apply --dry-run және дельта есебі тек SKILL.md хешін салыстырады. Қалтадағы анықтамалық файлдардың өзгерістері өзгерістер құрамында көрінбейді.

MCP Item

Жол:

mcp/<name>.yaml

Мысал:

name: context7
description: MCP арқылы кітапхана құжаттамасы
command: npx
args:
  - -y
  - "@upstash/context7-mcp"
targets:
  - claude-code
  - cursor
  - codex
env:
  - name: UPSTASH_REDIS_REST_URL
    description: Upstash Redis қоймасының URL-і
    required: true
    example: https://example.upstash.io

Өрістер:

Өріс	Міндетті	Сипаттама
name	иә	MCP сервері идентификаторы
description	иә	Қысқаша сипаттама
command	иә	Іске қосу командасы
args	иә	Аргументтер тізімі, бос болуы мүмкін
targets	иә	AI орталар тізімі
env	иә	Env айнымалылар тізімі, бос болуы мүмкін

Env айнымалысы

Өріс	Міндетті	Сипаттама
name	иә	Айнымалы атауы
description	иә	Айнымалының мақсаты
required	иә	Қолданғанда мән талап ету
example	жоқ	Мән мысалы

Env айнымалыларының мәндері MCP Item-де сақталмайды. Олар жергілікті белгіленіп, aim.local.yaml-да сақталады.

Targets

Қолдау көрсетілетін мәндер:

• claude-code;
• cursor;
• codex.