Skillget

cocoaskills

agent
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Local skill manager for AI agent skills: reproducible per-project installs, skill dependencies, security audit, multi-agent adapters (Claude Code, Codex CLI, Cursor, Gemini)

README.md

CocoaSkills

PyPI
Python versions
License
CI

Установщик csk управляет локальными пакетами скиллов для AI-агентов. Инструмент загружает скиллы из git-репозиториев и подготавливает файлы для шести сред: Claude Code, Codex CLI, Cursor, Gemini, OpenCode и Windsurf.

Зачем

Ручное управление скиллами в нескольких проектах создаёт проблемы при командной разработке. Содержимое файлов на компьютерах разработчиков расходится со временем. Без фиксации версий по тегам и коммитам обновления ломают рабочие окружения. Вспомогательные файлы, такие как README, тесты и файлы сборки, попадают в контекст агента и расходуют лимиты токенов. При удалении скилла из конфигурации неиспользуемые файлы остаются на диске.

Установщик csk решает эти проблемы декларативным описанием скиллов в Skillfile.json. Инструмент фиксирует версии git-репозиториев, копирует в контекст агента только SKILL.md и объявленные каталоги (references/, assets/, agents/, data/), исключая tests, README, файлы сборки и метаданные git, и удаляет устаревшие файлы при обновлении состава скиллов.

Рынок и позиция CocoaSkills

Публичные инструменты закрывают отдельные этапы работы с агентскими навыками. Корпоративный контур требует единой системы управления локальным окружением и цепочкой поставок.

Решение Основной фокус Сильная сторона Ограничения для задач компании
Vercel (skills.sh) Каталог и установка публичных навыков Масштаб экосистемы и поддержка множества агентов Ориентация на публичное распространение без защиты корпоративной цепочки поставки
SkillKit Универсальное управление для разных агентов Разнообразие интеграций, поиск и сканирование безопасности Уклон в индивидуальное использование без детерминированной воспроизводимости графа зависимостей
Tessl Корпоративное управление и реестр Приватные навыки, правила аудита и оценка качества Зависимость от централизованной платформы вместо локального менеджера пакетов
NVIDIA Skills / SkillSpector Безопасность, подлинность и проверка качества Цифровые подписи, сканирование угроз и бенчмарки Проверка и публикация без управления полным жизненным циклом локального окружения
Agent Plugins Открытый формат пакета Объединение навыков и инструментов MCP в единый стандарт Спецификация формата без функций установки, разрешения зависимостей и контроля правил

Установщик csk работает на уровне локальной инфраструктуры проекта. Инструмент воспроизводимо и безопасно управляет агентскими навыками со следующими свойствами:

  • Детерминированный граф зависимостей выявляет конфликты версий до начала установки.
  • Поддержка закрытых источников позволяет ограничить загрузку разрешёнными git-репозиториями.
  • Трёхуровневая изоляция разделяет контекст модели, исполняемую среду и артефакты сборки.
  • Транзакционная установка гарантирует откат к исходному состоянию при ошибках.
  • Каноническое состояние проекта не зависит от выбранного агента или среды разработки.
  • Локальная проверка правил безопасности работает без обязательной связи с внешними сервисами.

Существующие инструменты решают задачи каталогизации и проверки навыков; csk закрывает соседний уровень: детерминированную и воспроизводимую установку скиллов внутри закрытого корпоративного контура.

Почему CocoaSkills, а не альтернативы

Ручное копирование папок или создание symlink:

  • Где ломается: требует повторного копирования во всех проектах при обновлениях и переносит лишние файлы репозитория в контекст модели.
  • Что делает csk: автоматизирует загрузку, фильтрует содержимое до разрешённых каталогов и обновляет файлы одной командой.

Подключение через git submodules или git subtree:

  • Где ломается: сохраняет полную историю репозиториев, требует команд git при переключении веток и не формирует адаптеры для агентов.
  • Что делает csk: скачивает репозитории в локальный кэш, извлекает файлы скиллов и строит конфигурации для каждого агента.

Встроенные маркетплейсы плагинов внутри конкретных агентов:

  • Где ломается: привязывает скиллы к одному агенту и не позволяет использовать единый манифест в командах с разными инструментами.
  • Что делает csk: хранит единый Skillfile.json и раскладывает скиллы по адаптерам Claude Code, Codex CLI, Cursor и Gemini; OpenCode и Windsurf читают .agents/skills/ напрямую.

Общая директория скиллов с синхронизацией кастомными скриптами:

  • Где ломается: требует поддержки собственных скриптов, не проверяет контрольные суммы и не управляет транзитивными зависимостями.
  • Что делает csk: вычисляет граф зависимостей скиллов, фиксирует точные хеши содержимого и изолирует сгенерированные файлы.

Инструмент CocoaSkills доставляет скиллы и записывает объявления MCP в native project configs. csk не запускает MCP-серверы и не выполняет аутентификацию. Публичный реестр пакетов и runtime-среда агента остаются вне его задач.

Быстрый старт

  1. Установите CocoaSkills одним из способов. На macOS предпочтителен Homebrew:

    Homebrew (рекомендуется на macOS; также Linux) 
    brew tap ivanopcode/csk
brew install cocoaskills
    uv tool 
    UV_SYSTEM_CERTS=1 uv tool install cocoaskills
    pipx 
    pipx install cocoaskills
    mise 
    mise use -g pipx:cocoaskills@latest
    pip 
    python -m pip install --user cocoaskills

    Для установки из Python-экосистемы нужны uv 0.13.4+ или pip 26.2.2+, включая pip в shared venv pipx. Обновление: uv self update, python3 -m pip install --upgrade pip, pipx upgrade-shared.

    One-liner на macOS загружайте актуальным Homebrew curl (при необходимости brew install curl):

    "$(brew --prefix)/opt/curl/bin/curl" -fsSL https://cocoaskills.org/install.sh | sh

    Скрипт проверяет версии и выбирает uv, затем pipx, затем pip; uv запускается с UV_SYSTEM_CERTS=1. install.sh предназначен только для POSIX shell на macOS и Linux, не для установки на Windows. На Linux используйте актуальный curl. Пока macOS не обновит /etc/ssl/cert.pem, не используйте /usr/bin/curl для этой загрузки, а Apple git настройте на обновлённый bundle Homebrew:

    git config --global http.sslCAInfo "$(brew --prefix)/etc/ca-certificates/cert.pem"

    На Linux обновите пакет ca-certificates средствами дистрибутива: системные curl, git и Python читают его хранилище. Go-бинарники без встроенного x509 blocklist при проверке доверия полагаются только на этот системный bundle.

    На Windows Git for Windows по умолчанию использует OpenSSL и собственный bundle. Предпочтителен Schannel, чтобы применялось уже обновлённое хранилище Windows:

    git config --global http.sslBackend schannel

    Python с python.org использует хранилище Windows; минимумы uv 0.13.4+ и pip 26.2.2+ остаются теми же. Устанавливайте через Python-инструменты выше, без install.sh.

    Для приватных HTTPS-репозиториев сборки csk передаёт токен оператора в git на время fetch. На macOS перед использованием HTTPS build token убедитесь, что git доверяет обновлённому bundle; настройка обычных вызовов git показана выше (http.sslCAInfo). Изолированный fetch csk не читает пользовательскую и системную Git-конфигурацию; csk выбирает bundle самостоятельно, удаляет CA из встроенного списка отказа и закрепляет приватную PEM-копию. Для явного выбора используйте CSK_GIT_CA_BUNDLE или git.https_ca_bundle. Доступ к сборкам по SSH это не затрагивает.

    Подробности проверки клиентов и доверия хоста — в справочнике.

    Результат: команда csk --version выводит версию CocoaSkills.

  2. Создайте глобальную конфигурацию и настройте учётные данные до установки скиллов:

    csk bootstrap --if-missing --non-interactive --skills-root ~/skills --default-agents codex_cli

    Укажите каталог репозиториев скиллов в --skills-root; в PowerShell используйте "$HOME\skills". Без глобального config команды config build-ssh add и list завершаются с Global config not found. Флаг --if-missing сохраняет существующий config.

    SSH остаётся транспортом по умолчанию. Если соответствующий ключ уже загружен в ваш ssh-agent, выполните:

    csk config build-ssh add git.example.com/team --agent auto --identity ~/.ssh/build_key.pub

    Для незашифрованного файла без ssh-agent используйте csk config build-ssh add git.example.com/team --identity ~/.ssh/build_key.

    Команда сохраняет scope оператора. Режимы файла, ключи с passphrase, аппаратные ключи, ограничения платформ и другие ssh-agent, включая 1Password, описаны в руководстве по SSH.

  3. Перейдите в каталог проекта и инициализируйте конфигурацию:

    cd /path/to/project
csk init

    Результат: команда создаёт манифест Skillfile.json с начальной конфигурацией проекта и записывает блок директорий .agents/, .claude/skills/, .codex/skills/, .cursor/rules/, .gemini/skills/ и файла Skillfile.dev.json в локальный $GIT_COMMON_DIR/info/exclude. .gitignore не меняется. Linked worktrees используют общий exclude-файл.

  4. Добавьте объявление скилла в проект:

    csk add skill-tracker --git [email protected]:skills/skill-tracker.git --tag v1.0.0

    Результат: команда записывает объект скилла с именем skill-tracker, указанным репозиторием и тегом v1.0.0 в массив skills файла Skillfile.json.

  5. Выполните установку объявленных скиллов:

    csk install

    Результат: установщик скачивает репозиторий, извлекает файлы скилла в .agents/skills/skill-tracker/, генерирует адаптеры для указанных агентов и создаёт исполняемые шимы в .agents/bin/ для скиллов с командами.

  6. Проверьте доступность скилла в подключённом агенте:

    claude

    Результат: агент считывает инструкции из адаптера .claude/skills/ и применяет правила скилла skill-tracker в текущей сессии.

Учётные данные приватных репозиториев сборки

После csk bootstrap настройте учётные данные до первой установки по
руководству по SSH. Оно описывает ssh-agent,
ssh-agent с закреплённым публичным ключом и файловый режим. Содержимым
ssh-agent и сроком ключей управляет оператор. csk не запускает, не наполняет
и не обслуживает ssh-agent.

Если для SSH-репозитория нет сохранённого выбора, csk install в терминале
с интерактивными stdin и stdout показывает меню найденных кандидатов.
Enter выбирает первый вариант; следующий Enter принимает scope по умолчанию.
Без терминала отсутствие учётных данных даёт отказ с командами настройки.
Это меню выбора учётных данных, а не запрос SSH passphrase или PIN:
SSH-запросы остаются отключёнными, ключ загружает и разблокирует оператор.

HTTPS выбирается явно. См. учётные данные HTTPS.

Режимы установки скиллов

Установщик поддерживает три режима установки скиллов в зависимости от зоны ответственности и способа распространения файлов.

Проектный режим

Проектный режим фиксирует скиллы в файле Skillfile.json в корне репозитория. Разработчики коммитят этот файл в систему контроля версий. Вызов csk install на любой машине разворачивает одинаковый набор скиллов для всех участников команды.

Проектный Skillfile.json поддерживает schema 1, 2 и 3.

Схема 2 является основным форматом проектного Skillfile. Она объявляет источники и выбирает скиллы через селекторы. Команды csk check, csk install, csk upgrade и csk status поддерживают её по умолчанию.

Пример Skillfile.json схемы 2:

{
  "schema_version": 2,
  "project": { "alias": "demo-ios" },
  "agents": ["claude_code", "codex_cli", "cursor"],
  "sources": {
    "local": { "path": "." }
  },
  "skills": [
    {
      "name": "skill-tracker",
      "from": "local",
      "directory": "skills/skill-tracker"
    }
  ]
}

При работе со схемой 2 команда csk install выполняет начальную установку или устанавливает по файлу Skillfile.lock.json, команда csk upgrade явно обновляет лок, а csk status показывает актуальность манифеста и лока без записи. Команда csk check проверяет Skillfile без установки. Сетевые источники подчиняются файлу source-policy.json, который находится в ~/.cocoaskills/source-policy.json (путь переопределяется через CSK_SOURCE_POLICY). Подробное описание работы со схемой 2 приведено в docs/skillfile-sources.md.

Коммитьте Skillfile.lock.json вместе со Skillfile.json. На новой машине csk install восстанавливает отсутствующий снимок. Для path команда читает текущие байты. Для git и repository она получает точный commit из лока. Установка продолжится при совпадении идентичности и content_sha256. Расхождение вызывает source_snapshot_changed. Недоступный источник вызывает source_snapshot_unavailable и указывается в сообщении. Восстановление не меняет лок и не разрешает теги или ветки. csk upgrade явно обновляет лок по текущим источникам.

Схема 1 остаётся поддерживаемым legacy-форматом. Она напрямую объявляет список скиллов в секции skills:

{
  "schema_version": 1,
  "project": { "alias": "demo-ios" },
  "agents": ["claude_code", "codex_cli", "cursor"],
  "skills": [
    {
      "name": "skill-tracker",
      "git": "[email protected]:skills/skill-tracker.git",
      "tag": "v1.0.0"
    }
  ]
}

Как добавить MCP-сервер

Schema 3 добавляет к schema 2 поле mcp_servers. MCP-сервер даёт агенту (Claude Code, Codex CLI, Cursor) доступ к внешней системе. Сервер описывается в project Skillfile со "schema_version": 3, а csk install записывает его в конфиги агентов в проекте.

{
  "schema_version": 3,
  "agents": ["claude_code", "codex_cli", "cursor"],
  "skills": [],
  "mcp_servers": { "docs": "https://mcp.example.com/mcp" }
}
  1. Добавьте сервер в mcp_servers: строку с URL или объект server/install, если нужен токен или локальная программа.
  2. Запустите csk check: он проверяет объявления без записи и без сети.
  3. Запустите csk install в терминале. Если сервер запускает программу на вашей машине или передаёт токен, csk покажет точную команду и спросит согласие [y/N]. Без терминала согласие дать нельзя.
  4. csk status покажет current для каждой записи.
  5. Войдите в сервис в самом агенте. csk не запускает серверы, не выполняет вход и не хранит токены: в Skillfile указывается только имя переменной окружения.

Stdio host admission observes bounded current-platform native headers without
executing commands. Windows checks both modeled libuv and Rust PATH choices,
including quoted entries and dotted-name fallback. The 1024-byte selected-file
and 2-byte opaque-interpreter reads do not prove full loader or architecture
validity; implicit Windows search directories remain outside the model. See the
command admission boundary.

server.environments accepts the canonical ids claude_code, codex_cli, opencode, pi, muse. Without this selector, csk writes Claude Code, Codex CLI and csk-local Cursor independently of skill agents. Use "environments": ["claude_code"] to narrow it; add a separately approved Cursor destination with csk mcp local-target add cursor --server docs. Legacy Cursor selectors require csk mcp migrate before normal Skillfile edits. See the local-target and migration commands.

Ignore placement is project-local. In 0.21.x, a legacy top-level ignore_mode field continues to determine the effective mode until explicit migration removes it. Without that field, a managed CocoaSkill block in .gitignore selects gitignore; otherwise csk uses $GIT_COMMON_DIR/info/exclude. show names the source as a deprecated field, a managed block, or the default. Run csk ignore-mode show to inspect it, or csk ignore-mode set exclude / csk ignore-mode set gitignore to move the managed rules. User rules are preserved. The legacy top-level ignore_mode is input-only in schema 2/3: every load warns that other managers reject it, and ordinary Skillfile writers refuse with skillfile_deprecated_form. An explicit mode switch removes only that member without reformatting the Skillfile. Invalid legacy values still report ignore_mode_invalid; schema 1 cannot contain the field. A Skillfile is portable only after its deprecated forms have been migrated; 0.22 stops reading them. Outside a Git worktree, a switch refuses.

CocoaSkill хранит отдельный блок для каждого проекта/worktree между # CocoaSkill project <key> и # End CocoaSkill project <key>. Непрозрачный ключ определяется метаданными worktree и путём к корню проекта относительно репозитория. При обновлении меняется только собственный блок; остальные блоки и пользовательские байты остаются без изменений. Все операции записи выполняются по очереди под OS lock в постоянном файле $GIT_COMMON_DIR/csk-exclude.lock. При завершении процесса ОС освобождает lock; replay и rollback транзакции объединяют с текущим файлом только записанный блок проекта. Не удаляйте lock-файл, пока csk работает. Старые exclude-блоки без ключа сохраняются как существующие правила; удаляйте устаревшие записи вручную.

HTTP headers задаются в install.headers. Для токена используйте env reference, для несекретной настройки — literal:

{
  "install": {
    "headers": {
      "Authorization": { "env": "API_TOKEN", "prefix": "bearer" },
      "X-Scope": { "value": "issues,merge_requests" }
    },
    "auth": { "kind": "oauth" }
  }
}

OAuth совместим с headers. Env reference требует consent, одни literals — нет. Literal values ограничены 1024 UTF-8 bytes; секретные имена, совпадения secret scanner, $ и управляющие символы запрещены. Допустимые префиксы: none, bearer (только для Authorization), api-token и token. Codex отклоняет последние два с mcp_header_prefix_unsupported; для них явно выберите Claude Code/Cursor. См. recipes Allure и GitLab и полные ограничения.

Для stdio-серверов действуют ограничения:

  • Точная версия пакета. npx принимает только пакет@1.2.3, uvx только пакет==1.2.3.
  • Менеджеры пакетов и интерпретаторы только как сама команда. npx, node, python, sh и подобные не могут стоять в аргументах. Поэтому обёртки вроде find -exec npx pkg отклоняются.
  • Системные программы ОС не могут быть MCP-сервером. Исключения: xcrun mcpbridge и safaridriver --mcp.
  • На Windows .cmd и .bat не поддерживаются. Нужна обычная программа .exe или .com.
  • Остальные программы запускаются как есть. csk показывает их точную команду, но не может проверить, что они делают внутри.

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

{
  "proxyman": {
    "server": {
      "transport": "stdio",
      "launcher": {
        "macos": {
          "bundle_id": "com.proxyman.NSProxy",
          "team_id": "3X57WP8E8V",
          "executable": "Contents/MacOS/mcp-server"
        },
        "windows": {
          "install_dir": "%LOCALAPPDATA%\\Programs\\Proxyman",
          "executable": "mcp-server.exe",
          "publisher": "TablePlus Inc",
          "trust": "allow-unverified"
        },
        "linux": {
          "path": "${XDG_CONFIG_HOME:-~/.config}/Proxyman/bin/mcp-server",
          "trust": "allow-unverified"
        }
      }
    }
  }
}

Сначала установите Proxyman, затем выполните csk check, csk install в терминале
и csk status --check. csk показывает path/publisher/trust перед consent и пишет
абсолютный путь прямо в native configs, без запуска приложения. Windows recipe —
шаблон: проверьте точный Subject CN установленного helper. Другая подпись не
разрешается через allow-unverified.

Windows roots определяются через OS known-folder API, включая перенесённые каталоги. Противоречащие им значения env отклоняются с mcp_launcher_root_conflict; ошибка API даёт mcp_launcher_known_folder_unavailable без env fallback. Trust определяется разрешённым каталогом, содержащим helper; при пересечении каталогов LocalAppData имеет приоритет над Program Files.

Платформа Что проверяется Предел проверки
macOS Системный codesign: bundle, helper, notarization и идентичность издателя. Проверка на момент установки; нет гарантии для последующего запуска.
Windows WinVerifyTrust: валидная подпись и точное совпадение первого Subject CN с publisher. Program Files → verified, LocalAppData → signed-user-writable. Cached-only, без дополнительных revocation checks; нет гарантии актуального online revocation. Владелец per-user установки может заменить helper после проверки.
Linux Realpath и executable; файл и каждый родитель до объявленного root должны принадлежать текущему uid или root, без group/world write. Root-owned package helpers могут получить verified. При стандартном Ubuntu/Debian umask 002 может потребоваться однократный chmod -- g-w "$HOME/.local/bin". Отказ указывает точный элемент, mode и команду исправления; при указанном world write удалите также o-w. Package ownership не проверяет checksum содержимого.
Unverified Windows/Linux Нужны trust: allow-unverified и local consent. csk не отличает обновление от подмены; same-user attacker в per-user установке вне границы проверки. Vendor checksum для Proxyman не предполагается.

Изменение только содержимого при прежних path/trust/publisher информационное,
включая разрешённый unverified helper. Изменение path/publisher или trust downgrade
требует согласия. Невалидная подпись macOS/Windows блокирует установку и даёт
untrusted в status, --check возвращает 1; bad signature нельзя понизить до unsigned.
Crash recovery повторно проверяет сохранённую launcher observation до публикации. Старые command/HTTP journals восстанавливаются по записанным ledger targets без выдуманного launcher approval. Отсутствие launcher observation или неклассифицируемый сохранённый plan приостанавливает recovery; csk recover --rollback TRANSACTION_ID отменяет незавершённую публикацию, затем csk install рассматривает новый plan. Используйте тот же manager home и сохраняйте journal sidecars до успешного rollback.
Rollback восстанавливает journaled file/symlink preimages. Пустые каталоги установки могут остаться, прежние directory modes не восстанавливаются: например, consent directory после сужения с 0750 до 0700 может остаться 0700. Rollback не расширяет directory permissions.
transaction_cleanup_deferred означает committed install и необходимость повторить cleanup; transaction_rollback_deferred — необходимость recovery для rollback. Оба сохраняют journal, сообщают сохранённое состояние и возвращают 1; повторите csk install после восстановления затронутого приложения или publication boundary.
См. launcher grammar и ограничения.

Примеры для GitLab и Allure TestOps и то, чего пока нельзя: примеры и ограничения.

Все поля, проверки и коды ошибок: MCP в project Skillfile и Troubleshooting.

Глобальный режим

Глобальный режим устанавливает скиллы один раз на компьютере пользователя в каталог ~/.cocoaskills/global/. Глобальные скиллы работают во всех каталогах вне зависимости от наличия git-репозитория и файла Skillfile.json.

Команда добавляет глобальный скилл в конфигурацию пользователя:

csk global add skill-metrics --git [email protected]:skills/skill-metrics.git --tag v2.1.0

Команда csk global install скачивает репозиторий и записывает адаптеры в пользовательские директории агентов в домашнем каталоге.

Гибридный режим

Гибридный режим объявляет скиллы один раз на машине в файле ~/.cocoaskills/hybrid/Skillfile.json и активирует их для целевых проектов по алиасу, пути или глоб-шаблону. Установщик создаёт адаптеры в директориях агентов проекта (.claude/skills/, .codex/skills/) и шимы команд в .agents/bin/, но не требует коммитов в git-репозиторий. Платформенные команды используют гибридный режим для раскатки процессных правил и рабочих процессов на выбранные репозитории.

Команда связывает гибридный скилл с проектом по его алиасу:

csk hybrid add workflow-lint --git [email protected]:skills/workflow-lint.git --tag v1.2.0 --target "demo-ios"

При запуске csk install внутри проекта demo-ios установщик проверяет правила в ~/.cocoaskills/hybrid/Skillfile.json, находит совпадение по алиасу demo-ios и подключает скилл workflow-lint в локальный контекст агентов.

Порядок перекрытия скиллов

При совпадении имён скиллов в разных режимах установщик применяет следующий порядок приоритета: проектный режим перекрывает гибридный режим, а гибридный режим перекрывает глобальный режим (проектный > гибридный > глобальный).

Команды

Раздел содержит обзор основных команд csk по пяти функциональным группам.

Проект 
csk init [path]                     # Инициализирует Skillfile.json и локальные Git excludes
csk add <name>                      # Добавляет или обновляет объявление скилла в Skillfile.json
csk remove <name>                   # Удаляет объявление скилла из Skillfile.json
csk status [target]                 # Показывает статус установленных скиллов и манифеста
csk check [target]                  # Проверяет Skillfile без установки
csk list                            # Выводит список зарегистрированных проектов и скиллов
csk project add <alias> <path>      # Регистрирует путь проекта в глобальной конфигурации
csk project resolve [target]        # Показывает резолюцию манифеста и целевых путей
Скиллы и зависимости 
csk install [target]                # Устанавливает объявленные скиллы по локальным git-ссылкам
csk update                          # Выполняет git fetch для всех источников в skills_root
csk upgrade [target]                # Подтягивает обновления источников и выполняет установку
csk skill check <dir>               # Проверяет валидность структуры скилла и SKILL.md
Global и Hybrid 
csk global init                     # Создаёт глобальный манифест ~/.cocoaskills/global/Skillfile.json
csk global add <name>               # Добавляет объявление скилла в глобальный манифест
csk global remove <name>            # Удаляет скилл из глобального манифеста
csk global list                     # Выводит список объявленных глобальных скиллов
csk global status                   # Показывает статус установки глобальных скиллов
csk global install                  # Устанавливает глобальные скиллы в профиль пользователя
csk global update                   # Подтягивает git-источники глобальных скиллов
csk global upgrade                  # Подтягивает git-источники и устанавливает глобальные скиллы
csk hybrid add <name>               # Связывает гибридный скилл с целевыми проектами
csk hybrid remove <name>            # Удаляет объявление гибридного скилла
csk hybrid list                     # Выводит список гибридных скиллов и привязок
csk hybrid status                   # Показывает статус гибридных скиллов и хранилища
Сборки и аудит 
csk audit [target]                  # Запускает статический аудит безопасности скиллов
csk gc                              # Очищает неиспользуемые runtime-записи и кэш сборок

Installed runtime trees are read-only on POSIX; Windows permissions are unchanged.
runtime_tree_modified identifies foreign entries and prints an explicit removal
command. Keep skill caches and virtual environments outside installed trees; see
the runtime authoring contract.

Сервисные 
csk bootstrap                       # Создаёт глобальную конфигурацию ~/.cocoaskills/config.json
csk config show                     # Выводит путь и содержимое текущей конфигурации
csk shell-init                      # Генерирует или устанавливает код хука shell для PATH

Полное описание команд, флагов, позиционных аргументов и примеров использования находится в файле docs/cli.md.

Источники Skillfile schema 2

Схема 2 является основным форматом проектного Skillfile и поддерживается командами csk check, csk install, csk upgrade и csk status без дополнительной настройки. Схема 1 остаётся поддерживаемым legacy-форматом.

Настройка experimental.skillfile_sources и переменная CSK_EXPERIMENTAL_SKILLFILE_SOURCES сохраняют совместимость со старыми конфигурациями и не влияют на выбор схемы.

Команды переиспользуют общий интерфейс: csk install выполняет начальную установку или установку по локу, csk upgrade явно обновляет лок, csk status показывает актуальность без записи, а csk check проверяет Skillfile без установки. Команды установки читают источники path с диска, а источники git и repository получают через ограниченный транспорт по машинной политике source-policy.json. Руководство для авторов и операторов находится в docs/skillfile-sources.md. Историческое решение зафиксировано в RFC 0009.

Development tools

csk config build-ssh doctor [scope] prints read-only local SSH diagnostics and
operator setup steps to stdout; --all-os includes every supported OS. See
the CLI reference for verification limits.

Перед каждым запуском git csk выбирает и проверяет CA bundle, затем закрепляет
приватную копию оставшихся исходных PEM-блоков на время операции. CA из
встроенного списка отказа удаляются; предупреждение git_trust_anchor_distrusted
один раз за процесс называет CA и исходный путь. Пустой после фильтрации или
повреждённый bundle вызывает git_trust_anchor_invalid. Проверка охватывает SSH,
локальные команды и URL rewrites, которые могут привести к HTTPS.
Собственный актуальный PEM-файл задаётся через CSK_GIT_CA_BUNDLE
или git.https_ca_bundle глобальной конфигурации.
Порядок выбора и отказы.

  • uv installs the development environment and builds release artifacts. Run
    uv sync --extra dev and uv build --out-dir .temp/dist; build outputs stay
    under .temp/dist/.
  • pytest and pytest-xdist run the test suite. Run uv run pytest -q for the
    full suite or focused test paths; temporary output belongs under .temp/ or
    an external short-lived temp directory.
  • Go собирает команды go-v1 выбранным оператором go из PATH;
    проверьте его командой go version. Квалифицированы семейства 1.26 (от
    1.26.10) и 1.27 (от 1.27.3). Более ранние и prerelease-версии этих семейств
    отклоняются с insecure_go_release, семейства 1.25 и старше — с
    unsupported_go_family. Строка remediation: предлагает поставить Go
    1.27.3 или новее первым в PATH: например, go = "1.27.3" в проектном
    .mise.toml либо brew upgrade go. Порог нужен для исправленной проверки
    TLS-сертификатов: собранные CLI включают стандартную библиотеку выбранного Go.
    Новая версия тулчейна меняет cache key; следующая установка или обновление
    пересобирает CLI. Семейства новее 1.27 принимаются с предупреждением;
    строгий отказ задаётся через builds.go_future_families = "refuse" или
    CSK_GO_FUTURE_FAMILIES=refuse. CI закрепляет Go 1.26.10 и 1.27.3 через
    actions/setup-go@v7 в .github/workflows/ci.yml; кэш сборок находится в
    <csk-home>/builds/go-v1/.
  • mypy performs strict source type checking. Run uv run mypy; it writes no
    persistent artifact unless output is redirected to .temp/.
  • uv run python tests/audit_secrets_mutants.py runs the audit security
    narrowing mutants in disposable copies, including review regressions, and names each failing regression.
    Select a focused set with uv run python tests/audit_secrets_mutants.py raw-echo-if
    or run uv run pytest -q tests/test_usage_error_closure.py for the parser
    closure regressions. Save output under .temp/<TASK-ID>/.
  • uv run python tests/repointed_tags_mutants.py checks fetch and strict-tag
    narrowing mutants against the real CLI regressions in disposable copies.
    Logs and the named failing tests go under .temp/repointed-tags-mutants/.
  • Launcher PATH has a manager-owned prefix and a dependency suffix. The prefix
    holds only the skill bin directory and the manager interpreter directory and
    never depends on manifest content. Dependency directories resolve through the
    manager's tool_paths resolver and are appended after the inherited PATH, so
    the caller's PATH always wins. Run uv run pytest -q tests/test_launcher_tool_paths.py tests/test_tool_paths.py tests/test_tool_paths_symlinks.py tests/test_shims.py to check prefix
    independence, shim exclusion, symlink chains, refusal before publication,
    suffix order, and legitimate dependency launch. Save validation logs under
    .temp/.
  • /usr/bin/codesign — системный macOS trust verifier для app-bundled MCP
    launchers; Xcode CLT не требуется. Запускайте uv run pytest -q tests/test_mcp_launchers.py tests/test_mcp_launcher_lifecycle.py для grammar,
    trust и consent controls. macOS test с csk_e2e_native проверяет установленный
    Proxyman и меняет bytes только в disposable copy. Сохраняйте logs в .temp/;
    поиск приложения и проверка signature не записывают project state.
  • Windows использует системные wintrust.dll/crypt32.dll через ctypes для Authenticode;
    Linux — абсолютные /usr/bin/dpkg или /usr/bin/rpm для package ownership.
    Запускайте uv run pytest -q tests/test_mcp_authenticode.py tests/test_mcp_launcher_platforms.py tests/test_mcp_launcher_platform_lifecycle.py
    для переносимых controls, а uv run pytest -q -m csk_e2e_native tests/test_mcp_launcher_platform_native.py на Windows/Linux — для проверки
    реальных системных механизмов. Native tests пропускаются только на другой
    платформе; храните logs в .temp/ и явно отмечайте недоступные платформы.
  • csk recover --rollback TRANSACTION_ID восстанавливает записанные preimages
    незавершённой transaction под manager lock; committed transactions отклоняются.
    Пустые каталоги установки могут остаться, прежние directory modes не
    восстанавливаются и не расширяются. Запускайте uv run pytest -q tests/test_mcp_legacy_recovery.py tests/test_transaction_commit_guard.py в обычном Git checkout для crash fixtures
    released CLI и rollback controls; сохраняйте logs в .temp/.
  • PyYAML используется только в dev extra как независимый oracle для
    дифференциальных тестов frontmatter. Запускайте
    uv run pytest -q tests/test_frontmatter_differential.py; постоянные
    артефакты теста не создаются.
  • actionlint validates GitHub Actions workflows. Run
    actionlint .github/workflows/ci.yml; validation logs belong under .temp/.
  • .scripts/release.sh cuts and publishes signed stable releases. Run
    .scripts/release.sh 0.18.4 --wb-notes .temp/wb-release-0.18.4.md from a
    clean, current main checkout; use --dry-run to print every release step.
    Use .scripts/release.sh 0.20.0 --no-wb to defer the mirror without requiring
    glab or notes, then publish only that stage later with
    .scripts/release.sh 0.20.0 --resume-from wb --wb-notes .temp/wb-release-0.20.0.md.
    If distribution smoke fails, run its printed gh run rerun <run-id> --failed
    command manually, then resume with
    .scripts/release.sh 0.18.4 --resume-from verify.
    It requires gh, delivery, a loaded SSH signing key, curl, and
    mise; glab is required only when publishing the mirror stage.
    See RELEASING.md for the gates, Wildberries steps,
    and output behavior. It creates a local release branch and signed tag;
    published build artifacts stay in GitHub Actions and no local release log is
    retained.
  • GitHub Actions runs the cross-platform CI matrices. The merge protocol lane
    keeps full Linux/macOS coverage and uses the checked-in .research/ manifest,
    classification, and verifier for six deterministic Windows shards. Each
    Windows shard uploads its collected inventory, selected node IDs, verifier
    provenance, and JUnit XML as a workflow artifact.

Дальше

Документация и справочные материалы CocoaSkills:

  • docs/cli.md: справочник команд csk, флагов и кодов завершения.
  • docs/reference.md: справочник по матрице установки, зависимостям скиллов, манифестам и аудиту безопасности.
  • docs/ssh-key-setup.md: первоначальная настройка SSH, варианты для разных платформ и границы проверок.
  • docs/external-build-repositories.md: устройство внешних репозиториев сборки, брокеров кредов SSH/HTTPS и моделей доступа.
  • docs/design/linux-go-v1.md: Linux source-build design proposal, protocol requirements, qualification gates, and pending native probes.
  • docs/skillfile-sources.md: источники Skillfile schema 2, машинная транспортная политика и семантика лока.
  • docs/v0.16-design.md: RFC 0009, запись проектного решения о формате источников schema 2 (на английском).
  • ARCHITECTURE.md: описание внутренней архитектуры, схемы работы конвейера установки, формата хранилищ и модели безопасности.
  • SECURITY.md: политика безопасности, границы изоляции и рекомендации по настройке.
  • docs/skill-authoring.md: руководство по структурированию пакетов скиллов, объявлению команд и настройке манифеста agent-skill.json.
  • docs/authoring-cli-commands.md: руководство по поставке CLI-утилит в скиллах (Go, скрипт-команды, ограничения компилятора и планируемые языки).
  • docs/troubleshooting.md: диагностика ошибок установки, миграция со старых версий и решение частых проблем.
  • CHANGELOG.md: история релизов и список изменений по версиям.

Лицензия

Проект распространяется на условиях лицензии Apache 2.0.

MCP alias inventory tool

Run PYTHONDONTWRITEBYTECODE=1 PYTHONPATH=src uv run python .scripts/scan_mcp_evaluator_aliases.py > .temp/macos-evaluator-aliases.json
from the repository to audit system executable aliases without running them.
The scanner reads /usr/bin, /bin, /usr/sbin and /sbin; its dated output
records symlink, inode, shebang and literal exec evidence, plus unreadable-file
limits. Reviewed snapshots and package source links live in
tests/fixtures/mcp/macos-evaluator-aliases.json and
tests/fixtures/mcp/packaged-evaluator-aliases.json. Restricted editor aliases
and scripts interpreted by a refused program are conservatively refused too.

Run PYTHONDONTWRITEBYTECODE=1 uv run python .scripts/scan_mcp_base_commands.py > .temp/macos-base-commands.json
for a name/stat-only base-system snapshot. Review it with the documented package
families in tests/fixtures/mcp/base-system-commands.json; runtime policy data
is committed in src/csk/mcp_base_commands.py. Neither scanner executes programs.

The isolated Linux ELF identity developer checks are documented in
Linux ELF identity slice. Run
python -m pytest -q tests/test_linux_elf_identity.py and python -m mypy;
keep scratch logs in .temp/. These checks do not enable Linux source builds.

JSON input limits

Operator JSON documents are limited to 16 MiB and 256 nested containers.
File readers require regular files and check the opened descriptor before reading;
nonblocking admission rejects pipes/devices, and capped reads bound concurrent growth;
parsers check nesting before constructing the decoded value. Existing smaller
limits on native MCP files, registry evidence, and lock records still apply.
Canonical JSON encoding and strict duplicate-key, Unicode, and numeric checks
are unchanged. Run the focused boundary checks with
uv run --extra dev pytest tests/test_json_bounds.py tests/test_protocol_json.py;
temporary test artifacts belong in .temp/.

Reviews (0)

No results found