Documentation

ctx.yaml Specification

Every package is defined by a ctx.yaml manifest file.

Required fields

name: "@scope/name"    # @scope/name format
version: "1.0.0"       # semver
type: skill | mcp | cli
description: "..."     # max 1024 chars

Skill type

skill:
  entry: SKILL.md
  tags: [code-review, git]
  compatibility: "claude-code, cursor"

MCP type

mcp:
  transport: stdio
  command: npx
  args: ["-y", "@mcp/github"]
  env:
    - name: GITHUB_TOKEN
      required: true

CLI type

cli:
  binary: rg
  verify: "rg --version"
install:
  brew: ripgrep
  cargo: ripgrep