### Setup New Project - Verify installation

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Commands to verify the installation of skills and MCP servers.

```bash
# 4. Verify installation
caamp skills list --json
caamp mcp list --json
```

--------------------------------

### Skill Installation Patterns

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Examples of different ways to install skills using the CAAMP CLI.

```bash
# Install from GitHub
caamp skills install owner/repo --json --yes

# Install from marketplace
caamp skills install @scope/skill-name --json --yes

# Install with profile (multiple skills)
caamp skills install --profile core --json --yes
```

--------------------------------

### CLEO MCP channel workflows (install beta)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Example of installing the beta CLEO channel alongside the stable channel in JSON format.

```bash
caamp mcp install cleo --channel beta --provider claude-code --json
```

--------------------------------

### CAAMP Quick Start Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

A quick start example demonstrating how to use CAAMP functions to get providers, detect installed providers, and list MCP servers.

```typescript
import { getAllProviders, getInstalledProviders, listAllMcpServers } from "@cleocode/caamp";

// Get all registered providers
const providers = getAllProviders();

// Detect which are installed on this system
const installed = getInstalledProviders();

// List MCP servers across all installed providers
const servers = await listAllMcpServers(installed, "global");
```

--------------------------------

### CLEO MCP channel workflows (install stable)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Example of installing the stable CLEO channel to a specific provider in JSON format.

```bash
caamp mcp install cleo --channel stable --provider claude-code --json
```

--------------------------------

### Setup New Project - Install core skills

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to install core skills with automatic confirmation.

```bash
# 2. Install core skills
caamp skills install --profile core --json --yes
```

--------------------------------

### Setup New Project - Install essential MCP servers

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Commands to install essential MCP servers with automatic confirmation.

```bash
# 3. Install essential MCP servers
caamp mcp install @anthropic/mcp-server-fetch --json --yes
caamp mcp install @modelcontextprotocol/server-github --json --yes
```

--------------------------------

### CLEO MCP channel workflows (install dev)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Example of installing the dev CLEO channel with an isolated CLEO_DIR, specifying the command and arguments, in JSON format.

```bash
caamp mcp install cleo --channel dev --provider claude-code --command ./dist/mcp/index.js --arg --stdio --env CLEO_DIR=~/.cleo-dev --json
```

--------------------------------

### Programmatic API Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/PROVIDER-CONFIGURATION.md

TypeScript example demonstrating how to query provider capabilities programmatically using the CAAMP library.

```typescript
import {
  getProviderCapabilities,
  getProvidersBySkillsPrecedence,
  getProvidersByHookEvent,
  getSpawnCapableProviders,
  providerSupportsById,
} from "@cleocode/caamp";

// Get full capabilities for a provider
const caps = getProviderCapabilities("claude-code");
console.log(caps?.skills.precedence);     // "vendor-only"
console.log(caps?.hooks.supported);       // ["onSessionStart", ...]
console.log(caps?.spawn.spawnMechanism);  // "native"

// Filter providers by capability
const agentsFirst = getProvidersBySkillsPrecedence("agents-first");
const hookProviders = getProvidersByHookEvent("onToolComplete");
const spawnCapable = getSpawnCapableProviders();

// Check specific capability
const supportsSpawn = providerSupportsById("codex", "spawn.supportsSubagents");
```

--------------------------------

### Example usage of listAllMcpServers

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Shows how to get all installed providers and then list all configured MCP servers across them.

```typescript
import { getInstalledProviders, listAllMcpServers } from "@cleocode/caamp";

const installed = getInstalledProviders();
const allServers = await listAllMcpServers(installed, "global");
console.log(`${allServers.length} MCP servers configured`);
```

--------------------------------

### Install MCP Server

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Bash command to install an MCP server, with an example and a sample JSON response.

```bash
caamp mcp install <name> --json --yes
```

```bash
# Example:
caamp mcp install @anthropic/mcp-server-fetch --json --yes
```

```json
# Response:
{
  "success": true,
  "result": {
    "installed": [{
      "name": "@anthropic/mcp-server-fetch",
      "providers": ["claude-code"],
      "config": {
        "command": "npx",
        "args": ["-y", "@anthropic/mcp-server-fetch"]
      }
    }]
  }
}
```

--------------------------------

### Setup New Project - Detect installed agents

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to detect installed agents as part of setting up a new project.

```bash
# 1. Detect installed agents
caamp providers detect --json
```

--------------------------------

### installBatchWithRollback() usage example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

An example of using `installBatchWithRollback` for installing MCP servers and skills, including error handling.

```typescript
import { installBatchWithRollback } from "@cleocode/caamp";

const result = await installBatchWithRollback({
  minimumPriority: "high",
  mcp: [
    {
      serverName: "filesystem",
      config: { command: "npx", args: ["-y", "@modelcontextprotocol/server-filesystem"] },
      scope: "project",
    },
  ],
  skills: [
    {
      sourcePath: "/tmp/my-skill",
      skillName: "my-skill",
      isGlobal: true,
    },
  ],
});

if (!result.success) {
  console.error("batch failed:", result.error);
  console.error("rollback errors:", result.rollbackErrors);
}
```

--------------------------------

### Install a Skill

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Bash command to install a skill using CAAMP, with examples of different source types and a sample JSON response.

```bash
caamp skills install <source> --json --yes
```

```bash
# Example:
caamp skills install ct-gitbook --json --yes
```

```json
# Response:
{
  "success": true,
  "result": {
    "installed": [{
      "name": "ct-gitbook",
      "scopedName": "ct-gitbook",
      "canonicalPath": "/home/user/.agents/skills/ct-gitbook",
      "providers": ["claude-code", "cursor"]
    }],
    "failed": [],
    "count": { "installed": 1, "failed": 0, "total": 1 }
  }
}
```

--------------------------------

### Skills Commands Examples

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

Examples of common CAAMP skills commands for listing, finding, installing, removing, checking, updating, auditing, validating, and initializing skills.

```bash
# List skills (JSON)
caamp skills list --global
```

```bash
# List skills (human-readable)
caamp skills list --global --human
```

```bash
# Find skills
caamp skills find gitbook
```

```bash
# Install skill
caamp skills install <source>
```

```bash
# Remove skill
caamp skills remove <name>
```

```bash
# Check for updates
caamp skills check
```

```bash
# Update skills
caamp skills update
```

```bash
# Audit skill
caamp skills audit <path>
```

```bash
# Validate skill
caamp skills validate <path>
```

```bash
# Initialize new skill
caamp skills init <name>
```

--------------------------------

### MCP Server Installation from GitHub

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to install an MCP server from a GitHub repository.

```bash
# Install from GitHub
caamp mcp install owner/repo --json --yes
```

--------------------------------

### MCP Commands Examples

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

Examples of CAAMP MCP commands for listing, installing, removing, and detecting MCP servers.

```bash
# List MCP servers
caamp mcp list
```

```bash
# Install MCP server
caamp mcp install <name>
```

```bash
# Remove MCP server
caamp mcp remove <name>
```

```bash
# Detect MCP servers
caamp mcp detect
```

--------------------------------

### recordSkillInstall() usage example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Example of how to use the recordSkillInstall function to record a skill installation.

```typescript
import { recordSkillInstall, getCanonicalSkillsDir } from "@cleocode/caamp";
import { join } from "node:path";

await recordSkillInstall(
  "my-skill",
  "@author/my-skill",
  "github:author/my-skill",
  "github",
  ["claude-code"],
  join(getCanonicalSkillsDir(), "my-skill"),
  true
);
```

--------------------------------

### getInstalledProviders() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Example of retrieving only the providers that are detected as installed on the system.

```typescript
import { getInstalledProviders } from "@cleocode/caamp";

const installed = getInstalledProviders();
// Use these for operations that target installed agents
```

--------------------------------

### Best Practice: Use --yes to Skip Prompts

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Examples of using the --yes flag for non-interactive mode during installation.

```bash
# Non-interactive mode
caamp skills install <skill> --json --yes
caamp mcp install <server> --json --yes
```

--------------------------------

### MCP Server Installation from npm

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to install an MCP server from npm.

```bash
# Install from npm
caamp mcp install @anthropic/mcp-server-fetch --json --yes
```

--------------------------------

### detectProvider() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Example of detecting if a single provider is installed and checking detection methods.

```typescript
import { getProvider, detectProvider } from "@cleocode/caamp";

const claude = getProvider("claude-code")!;
const result = detectProvider(claude);
console.log(result.installed); // true
console.log(result.methods);   // ["binary"]
```

--------------------------------

### detectAllProviders() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Example of detecting all registered providers and counting installed ones.

```typescript
import { detectAllProviders } from "@cleocode/caamp";

const results = detectAllProviders();
const installed = results.filter(r => r.installed);
console.log(`${installed.length} agents detected`);
```

--------------------------------

### Run batch installation

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/ADVANCED-CLI.md

Example of running a rollback-capable batch installation for MCP servers and skills.

```bash
caamp advanced batch \
  --mcp-file ./mcp-batch.json \
  --skills-file ./skills-batch.json \
  --min-tier medium
```

--------------------------------

### CAAMP Progressive Disclosure Examples

Source: https://github.com/kryptobaseddev/caamp/blob/main/claudedocs/VISION.md

Shows different ways to use the `caamp mcp install` command, from simple to advanced, including targeted installation, dry runs, and JSON output.

```bash
# Simple: install to all detected agents
caamp mcp install https://mcp.example.com --all

# Targeted: install to specific agents
caamp mcp install https://mcp.example.com -a claude-code -a cursor

# Controlled: preview without writing
caamp mcp install https://mcp.example.com --all --dry-run

# Scriptable: JSON output for automation
caamp providers detect --json
```

--------------------------------

### Install CAAMP

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to install CAAMP globally using npm.

```bash
npm install -g @cleocode/caamp
```

--------------------------------

### recordMcpInstall() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Shows how to record an MCP server installation in the lock file.

```typescript
import { recordMcpInstall } from "@cleocode/caamp";

await recordMcpInstall("my-server", "npx my-server", "command", ["claude-code"], true);
```

--------------------------------

### getTrackedMcpServers() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Demonstrates retrieving all tracked MCP server installations and logging their installation dates.

```typescript
import { getTrackedMcpServers } from "@cleocode/caamp";

const tracked = await getTrackedMcpServers();
for (const [name, entry] of Object.entries(tracked)) {
  console.log(`${name}: installed ${entry.installedAt}`);
}
```

--------------------------------

### CAAMP Auto-detection and Configuration Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/claudedocs/VISION.md

Demonstrates a common CAAMP command that automatically detects installed agents and installs configurations to all of them.

```bash
# Auto-detect which agents are installed, install to all of them
caamp mcp install @anthropic/mcp-server-filesystem --all

# CAAMP figures out:
# - Which agents are installed (binary check, directory check, app bundle check)
# - Where each agent's config file lives
# - What format each config file uses
# - What config key each agent expects
# - Whether a transform is needed
```

--------------------------------

### Provider Commands Examples

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

Examples of CAAMP provider commands for listing, detecting, and showing provider details.

```bash
# List providers
caamp providers list
```

```bash
# Detect installed providers
caamp providers detect
```

```bash
# Show provider details
caamp providers show <id>
```

--------------------------------

### Sync Across Agents - Install to all detected agents

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to install a skill to all detected agents.

```bash
# Install to all detected agents
caamp skills install <skill> --json --yes --all
```

--------------------------------

### CLEO MCP channel workflows (interactive human flow)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Example of an interactive human flow for CLEO MCP installs using a bridge TUI.

```bash
caamp mcp cleo install --interactive --human
```

--------------------------------

### applyMcpInstallWithPolicy() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Applies MCP install plan with a specified conflict policy.

```typescript
async function applyMcpInstallWithPolicy(
  providers: Provider[],
  operations: McpBatchOperation[],
  policy?: ConflictPolicy,
  projectDir?: string
): Promise<McpPlanApplyResult>
```

```typescript
import { applyMcpInstallWithPolicy, getInstalledProviders } from "@cleocode/caamp";

const result = await applyMcpInstallWithPolicy(
  getInstalledProviders(),
  [{ serverName: "github", config: { command: "npx", args: ["-y", "@modelcontextprotocol/server-github"] } }],
  "skip",
);
```

--------------------------------

### Example usage of resolveConfigPath

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Shows how to get a provider and then use resolveConfigPath to find the project-level configuration file path.

```typescript
import { getProvider, resolveConfigPath } from "@cleocode/caamp";

const claude = getProvider("claude-code")!;
const path = resolveConfigPath(claude, "project", "/my/project");
// "/my/project/.mcp.json"
```

--------------------------------

### Providers help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for various subcommands under 'providers'.

```bash
caamp providers --help
caamp providers list --help
caamp providers detect --help
caamp providers show --help
```

--------------------------------

### Instructions help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for various subcommands under 'instructions'.

```bash
caamp instructions --help
caamp instructions inject --help
caamp instructions check --help
caamp instructions update --help
```

--------------------------------

### Provider capabilities help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for provider-related capabilities, skills, and hooks.

```bash
caamp providers skills-map --help
caamp providers hooks --help
caamp providers capabilities --help
```

--------------------------------

### MCP help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for various subcommands under 'mcp'.

```bash
caamp mcp --help
caamp mcp install --help
caamp mcp remove --help
caamp mcp list --help
caamp mcp detect --help
caamp mcp cleo --help
caamp mcp cleo install --help
caamp mcp cleo update --help
caamp mcp cleo uninstall --help
caamp mcp cleo show --help
```

--------------------------------

### CLEO MCP channel workflows (update/uninstall/show)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Examples for updating, uninstalling, and showing compatibility for CLEO MCP channels in JSON format.

```bash
caamp mcp update cleo --channel beta --provider claude-code --json
caamp mcp uninstall cleo --channel dev --provider claude-code --json
caamp mcp show cleo --provider claude-code --json
```

--------------------------------

### Full capability matrix

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Examples for displaying the full capability matrix in human and JSON formats.

```bash
caamp providers capabilities --human
caamp providers capabilities --filter spawn.supportsSubagents --json
```

--------------------------------

### CAAMP CLI Examples

Source: https://github.com/kryptobaseddev/caamp/blob/main/claudedocs/VISION.md

Demonstrates common CAAMP commands for installing MCP servers, skills, and managing instructions across AI agents.

```bash
# Install an MCP server to all detected agents
caamp mcp install https://mcp.example.com/api --all

# Install a skill from GitHub to Claude Code and Cursor
caamp skills install owner/repo --agent claude-code --agent cursor

# Check what's installed across all agents
caamp mcp list --all

# Inject project instructions into all instruction files
caamp instructions inject
```

--------------------------------

### Shell Integration

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Example of integrating CAAMP with shell scripts, including a function to install and verify skills.

```bash
#!/bin/bash

# Install skill and verify
install_skill() {
  local skill_name=$1
  local result=$(caamp skills install "$skill_name" --json --yes)
  
  if echo "$result" | jq -e '.success' > /dev/null; then
    echo "✓ Installed $skill_name"
    return 0
  else
    echo "✗ Failed to install $skill_name"
    echo "$result" | jq '.error.message'
    return 1
  fi
}

# Usage
install_skill "ct-gitbook"
```

--------------------------------

### Skills help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for various subcommands under 'skills'.

```bash
caamp skills --help
caamp skills install --help
caamp skills remove --help
caamp skills list --help
caamp skills find --help
caamp skills check --help
caamp skills update --help
caamp skills init --help
caamp skills validate --help
caamp skills audit --help
```

--------------------------------

### Skills recommendation flow (human mode)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Example of the skills recommendation flow in human-readable mode, showing a ranked list and a CHOOSE line.

```bash
caamp skills find "docs quality" --recommend --top 3 --must-have docs --prefer markdown
# ...
# [1] @owner/skill-a ...
# [2] @owner/skill-b ...
# [3] @owner/skill-c ...
# CHOOSE: 1,2,3
```

--------------------------------

### selectProvidersByMinimumPriority() usage example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

An example demonstrating the usage of `selectProvidersByMinimumPriority` with installed providers.

```typescript
import { getInstalledProviders, selectProvidersByMinimumPriority } from "@cleocode/caamp";

const installed = getInstalledProviders();
const target = selectProvidersByMinimumPriority(installed, "medium");
// includes high + medium providers
```

--------------------------------

### Show provider details

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/PROVIDER-CONFIGURATION.md

Commands to show specific details for providers.

```bash
caamp providers show claude-code
```

```bash
caamp providers show codex
```

```bash
caamp providers show zed
```

--------------------------------

### Configure global and project settings for a provider

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/ADVANCED-CLI.md

Example of configuring both global and project settings for a provider.

```bash
caamp advanced configure \
  -a claude-code \
  --global-mcp-file ./global-mcp.json \
  --project-mcp-file ./project-mcp.json \
  --instruction-file ./agent-block.md
```

--------------------------------

### Query skills precedence

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Examples for querying skills precedence across providers in human and JSON formats.

```bash
caamp providers skills-map --human
caamp providers skills-map --provider codex --json
```

--------------------------------

### Config and Doctor help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for 'config' and 'doctor' commands.

```bash
caamp config --help
caamp config show --help
caamp config path --help
caamp doctor --help
```

--------------------------------

### Mid-Size Project Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/AGENTS-DIRECTORY-STANDARD.md

An example project structure including .agents directory with skills, wiki, and mcp subdirectories.

```tree
my-app/
├── .agents/
│   ├── AGENTS.md
│   ├── skills/
│   │   ├── testing.md
│   │   └── code-review.md
│   ├── wiki/
│   │   ├── architecture.md
│   │   └── glossary.md
│   └── mcp/
│       └── servers.json
├── src/
├── tests/
├── package.json
└── README.md
```

--------------------------------

### resolveProviderSkillsDirs() Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Example of resolving skill installation directories for a given provider and scope.

```typescript
import { getProvider, resolveProviderSkillsDirs } from "@cleocode/caamp";

const claude = getProvider("claude-code")!;
const dirs = resolveProviderSkillsDirs(claude, "global");
// ["/home/user/.claude/skills"]
```

--------------------------------

### Extensions Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

An example of CAAMP's `_extensions` field for vendor-specific metadata.

```json
{
  "_extensions": {
    "x-caamp-timing": {
      "executionMs": 42
    },
    "x-caamp-source": {
      "gitRef": "abc123"
    }
  }
}
```

--------------------------------

### Other Commands Examples

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

Examples for CAAMP doctor, config management, and instructions commands.

```bash
# Doctor (health check)
caamp doctor
```

```bash
# Config management
caamp config show <provider>
caamp config path <provider>
```

```bash
# Instructions
caamp instructions check
caamp instructions inject
caamp instructions update
```

--------------------------------

### Query hook support

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Examples for querying hook support in human and JSON formats.

```bash
caamp providers hooks --human
caamp providers hooks --event onToolComplete --json
caamp providers hooks --common
```

--------------------------------

### getEffectiveSkillsPaths Usage Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Example demonstrating how to get global skills paths for a provider.

```typescript
import { getProvider, getEffectiveSkillsPaths } from "@cleocode/caamp";

const claude = getProvider("claude-code")!;
const paths = getEffectiveSkillsPaths(claude, "global");
// [{ path: "/home/user/.claude/skills", source: "vendor", scope: "global" }]
```

--------------------------------

### Small Project Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/AGENTS-DIRECTORY-STANDARD.md

A minimal project structure demonstrating the placement of the .agents directory at the root.

```tree
my-app/
├── .agents/
│   └── AGENTS.md
├── src/
├── package.json
└── README.md
```

--------------------------------

### Detect Installed Providers

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to detect installed CAAMP providers and their JSON response.

```bash
caamp providers detect --json
```

```json
{
  "success": true,
  "result": {
    "installed": [
      {
        "id": "claude-code",
        "toolName": "Claude Code",
        "methods": ["binary", "directory"],
        "projectDetected": false
      }
    ],
    "notInstalled": ["cursor", "codex"],
    "count": { "installed": 1, "total": 44 }
  }
}
```

--------------------------------

### Error Structure Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

An example of the JSON structure for an error response when success is false.

```json
{
  "success": false,
  "error": {
    "code": "E_SKILL_NOT_FOUND",
    "message": "Skill 'my-skill' not found",
    "category": "NOT_FOUND",
    "retryable": false,
    "retryAfterMs": null,
    "details": {
      "skillName": "my-skill"
    }
  }
}
```

--------------------------------

### Advanced help

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Shows help for various subcommands under 'advanced'.

```bash
caamp advanced --help
caamp advanced providers --help
caamp advanced batch --help
caamp advanced conflicts --help
caamp advanced apply --help
caamp advanced instructions --help
caamp advanced configure --help
```

--------------------------------

### Example usage of listCanonicalSkills()

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

An example demonstrating how to use listCanonicalSkills to get a list of skill names.

```typescript
import { listCanonicalSkills } from "@cleocode/caamp";

const skills = await listCanonicalSkills();
// ["my-skill", "debug-helper", "code-review"]
```

--------------------------------

### Skills recommendation flow (JSON mode)

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/CLI-HELP-EXAMPLES.md

Example of the skills recommendation flow in JSON mode, including the LAFS envelope and recommendation payload.

```bash
caamp skills find "docs quality" --recommend --json --top 3 --details
```

--------------------------------

### CAAMP Install Once, Link Everywhere Model

Source: https://github.com/kryptobaseddev/caamp/blob/main/claudedocs/VISION.md

Illustrates the canonical skill storage and symlink creation across different agent directories.

```text
~/.agents/skills/my-skill/         <-- Canonical copy (one source of truth)
    SKILL.md
    resources/

~/.claude/skills/my-skill -> ~/.agents/skills/my-skill   (symlink)
~/.cursor/skills/my-skill -> ~/.agents/skills/my-skill    (symlink)
~/.gemini/skills/my-skill -> ~/.agents/skills/my-skill    (symlink)
```

--------------------------------

### installSkill()

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/API-REFERENCE.md

Installs a skill from a local path: copies to the canonical location (`getCanonicalSkillsDir()/<name>`) and creates symlinks in each target provider's skills directory.

```typescript
async function installSkill(
  sourcePath: string,
  skillName: string,
  providers: Provider[],
  isGlobal: boolean,
  projectDir?: string
): Promise<SkillInstallResult>
```

```typescript
import { getInstalledProviders, installSkill } from "@cleocode/caamp";

const providers = getInstalledProviders();
const result = await installSkill(
  "/tmp/my-skill",
  "my-skill",
  providers,
  true
);

console.log(result.canonicalPath); // e.g. "<AGENTS_HOME>/skills/my-skill/"
console.log(result.linkedAgents);  // ["claude-code", "cursor"]
```

--------------------------------

### JSON LAFS Envelope Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LAFS_COMPLIANCE.md

An example of a LAFS-compliant JSON envelope for a skills list operation.

```json
{
  "$schema": "https://lafs.dev/schemas/v1/envelope.schema.json",
  "_meta": {
    "specVersion": "1.0.0",
    "schemaVersion": "1.0.0",
    "timestamp": "2026-02-18T12:00:00Z",
    "operation": "skills.list",
    "requestId": "req_abc123",
    "transport": "cli",
    "strict": true,
    "mvi": "standard",
    "contextVersion": 0,
    "sessionId": "sess_xyz789"
  },
  "success": true,
  "result": {
    "skills": [...],
    "count": 42
  },
  "error": null,
  "page": null
}
```

--------------------------------

### Link File Format Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/AGENTS-DIRECTORY-STANDARD.md

Illustrates the structure of Markdown files within the 'links/' directory, showing how to reference external resources like design tools and brand guidelines.

```markdown
# Design Resources

## Figma

- **Main Design System:** https://figma.com/file/xxx
- **Component Library:** https://figma.com/file/yyy

## Brand Guidelines

- **Brand Kit:** https://example.com/brand
```

--------------------------------

### Auto-detect installed MCP servers

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Command to detect installed MCP servers and output in JSON format.

```bash
caamp mcp detect --json
```

--------------------------------

### Environment Variable Reference in Server Configuration

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/AGENTS-DIRECTORY-STANDARD.md

Demonstrates how to reference environment variables within server definitions for dynamic configuration.

```json
{
  "servers": {
    "database": {
      "type": "stdio",
      "command": "mcp-server-postgres",
      "args": ["${DATABASE_URL}"]
    }
  }
}
```

--------------------------------

### List Installed Skills

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/LLM-AGENT-GUIDE.md

Bash command to list globally installed skills, with a sample JSON response.

```bash
caamp skills list --global --json
```

```json
# Response:
{
  "success": true,
  "result": {
    "skills": [
      {
        "name": "ct-gitbook",
        "scopedName": "ct-gitbook",
        "path": "/home/user/.agents/skills/ct-gitbook",
        "metadata": {
          "description": "GitBook platform skill...",
          "version": "1.0.0"
        }
      }
    ],
    "count": 1,
    "scope": "global"
  }
}
```

--------------------------------

### Plugin System Example

Source: https://github.com/kryptobaseddev/caamp/blob/main/claudedocs/GAP-ANALYSIS.md

Example of how a community-contributed provider can be defined for the plugin system.

```typescript
// ~/.caamp/plugins/my-provider.js
export default {
  id: "my-custom-agent",
  toolName: "My Custom Agent",
  // ... provider fields
};
```

--------------------------------

### Re-run provider detection

Source: https://github.com/kryptobaseddev/caamp/blob/main/docs/MIGRATION-v1.md

Re-run provider detection for the project.

```bash
caamp providers detect --project
```