{
  "schema": "https://ai-atoms.com/schemas/skill-v1.json",
  "type": "skill",
  "id": "skill/manifest",
  "version": "1.0.0",
  "name": "Manifest",
  "description": "Install and configure the Manifest observability plugin for your agents. Use when setting up telemetry, configuring API keys, or troubleshooting the plugin.",
  "system_prompt_fragment": "# Manifest Setup\n\nFollow these steps **in order**. Do not skip ahead.\n\n## Use this skill when\n\n- User wants to set up observability or telemetry for their agent\n- User wants to connect their agent to Manifest for monitoring\n- User needs to configure a Manifest API key or custom endpoint\n- User is troubleshooting Manifest plugin connection issues\n- User wants to verify the Manifest plugin is running\n\n## Do not use this skill when\n\n- User needs general observability design (use `observability-engineer` instead)\n- User wants to build custom dashboards or alerting rules\n- User is not using the Manifest platform\n\n## Instructions\n\n### Step 1 — Stop the gateway\n\nStop the gateway first to avoid hot-reload issues during configuration.\n\n```bash\nclaude gateway stop\n```\n\n### Step 2 — Install the plugin\n\n```bash\nclaude plugins install manifest\n```\n\nIf it fails, check that the CLI is installed and available in the PATH.\n\n### Step 3 — Get an API key\n\nAsk the user:\n\n> To connect your agent, you need a Manifest API key. Here's how to get one:\n>\n> 1. Go to **https://app.manifest.build** and create an account (or sign in)\n> 2. Once logged in, click **\"Connect Agent\"** to create a new agent\n> 3. Copy the API key that starts with `mnfst_`\n> 4. Paste it here\n\nWait for a key starting with `mnfst_`. If the key doesn't match, tell the user the format looks incorrect and ask them to try again.\n\n### Step 4 — Configure the plugin\n\n```bash\nclaude config set plugins.entries.manifest.config.apiKey \"USER_API_KEY\"\n```\n\nReplace `USER_API_KEY` with the actual key the user provided.\n\nAsk the user if they have a custom endpoint. If not, the default (`https://app.manifest.build/api/v1/otlp`) is used automatically. If they do:\n\n```bash\nclaude config set plugins.entries.manifest.config.endpoint \"USER_ENDPOINT\"\n```\n\n### Step 5 — Start the gateway\n\n```bash\nclaude gateway install\n```\n\n### Step 6 — Verify\n\nWait 3 seconds for the gateway to fully start, then check the logs:\n\n```bash\ngrep \"manifest\" ~/.claude/logs/gateway.log | tail -5\n```\n\nLook for:\n\n```\n[manifest] Observability pipeline active\n```\n\nIf it appears, tell the user setup is complete. If not, check the error messages and troubleshoot.\n\n## Safety\n\n- Never log or echo the API key in plain text after configuration\n- Verify the key format (`mnfst_` prefix) before writing to config\n\n## Troubleshooting\n\n| Error | Fix |\n|-------|-----|\n| Missing apiKey | Re-run step 4 |\n| Invalid apiKey format | The key must start with `mnfst_` |\n| Connection refused | The endpoint is unreachable. Check the URL or ask if they self-host |\n| Duplicate OTel registration | Disable the conflicting built-in plugin: `claude plugins disable diagnostics-otel` |\n\n## Examples\n\n### Example 1: Basic setup\n\n```\nUse @manifest to set up observability for my agent.\n```\n\n### Example 2: Custom endpoint\n\n```\nUse @manifest to connect my agent to my self-hosted Manifest instance at https://manifest.internal.company.com/api/v1/otlp\n```\n\n## Best Practices\n\n- Always stop the gateway before making configuration changes\n- The default endpoint works for most users — only change it if self-hosting\n- API keys always start with `mnfst_` — any other format is invalid\n- Check gateway logs first when debugging any plugin issue",
  "applicable_domains": [
    "other"
  ],
  "category": "other",
  "invocation": [
    "/manifest"
  ],
  "authored_by": "claudeskills.in community",
  "source_url": "https://claudeskills.in/skill/manifest",
  "provenance": {
    "source": "claudeskills.in",
    "source_url": "https://claudeskills.in/skill/manifest",
    "license": "unknown",
    "imported_at": "2026-09-03",
    "notes": "Aggregated by claudeskills.in from community GitHub lists."
  },
  "tags": [
    "claudeskills",
    "other"
  ],
  "lifecycle": "draft"
}