{
  "schema": "snappy-card/1",
  "skill": "snappy-skill",
  "tier": "public",
  "origin_tier": "base",
  "purpose": "The scaffolder for Snappy. One verb, idempotent, templates as files.",
  "verbs": [
    {
      "name": "scaffold",
      "args": [
        "name"
      ],
      "effect": "write-reversible",
      "firstCall": "npx tsx ~/.claude/skills/snappy-skill/api.ts scaffold \"<name>\""
    }
  ],
  "faces": [],
  "agents": [],
  "uses": [
    "snappy-settings",
    "snappy-client-template",
    "snappy-gateway"
  ],
  "used_by": [
    "snappy-client-ray"
  ],
  "checks": {
    "pass": 30,
    "fail": 4,
    "defer": 27,
    "line": "30 of 34 checks pass",
    "failing": [
      {
        "id": 10,
        "rule": "One term names each concept",
        "says": "mixed synonym sets: endpoint/url/route/path"
      },
      {
        "id": 54,
        "rule": "At least three eval scenarios precede ready status",
        "says": "0 eval scenario(s); ready=true"
      },
      {
        "id": 55,
        "rule": "Eval scenarios are multi-call with ground truth",
        "says": "eval manifest missing"
      },
      {
        "id": 57,
        "rule": "Eval manifest contains a disjoint holdout",
        "says": "0 disjoint holdout scenario(s)"
      }
    ]
  },
  "coverage": null,
  "spec": null,
  "evals": null,
  "files": [
    "AGENTS.md",
    "SKILL.md",
    "api.ts",
    "refusals.test.ts",
    "templates/AGENTS.md",
    "templates/SKILL.md",
    "templates/api.ts",
    "validate.ts"
  ],
  "total_size": 34584,
  "checksum": "sha256:10fa8bf2254474474a308b6e683227ee1bc61726ba9844c3d229e685af9a2c1a",
  "built_at": "2026-09-09T22:10:57.852Z",
  "openapi": {
    "openapi": "3.1.0",
    "info": {
      "title": "snappy-skill",
      "version": "0.0.0",
      "description": "Meta-skill for the snappy-* namespace. One verb, `scaffold(name, options?)`, that creates a new skill or fills in missing files on an existing one. Idempotent by design: running it on a clean skill is a no-op. Templates live as real files on disk under `templates/`. Validation delegates to skill-check.sh, the single source of truth for \"is this skill valid.\" Triggers on: create snappy skill, new snappy skill, scaffold snappy, extend snappy skill, snappy meta skill, snappy three-file, snappy scaffolder, snappy drift."
    },
    "x-snappy-transport": "cli",
    "servers": [
      {
        "url": "npx tsx ~/.claude/skills/snappy-skill/api.ts",
        "description": "The hand itself. Every path is a verb word, every query or body key an argument."
      }
    ],
    "paths": {
      "/scaffold": {
        "post": {
          "operationId": "snappy_skill_scaffold",
          "summary": "snappy-skill scaffold",
          "x-snappy-effect": "write-reversible",
          "x-snappy-annotations": {
            "readOnlyHint": false,
            "destructiveHint": false,
            "idempotentHint": false,
            "openWorldHint": false
          },
          "requestBody": {
            "required": true,
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string",
                      "description": "Name of the thing to act on",
                      "x-snappy-position": 0
                    }
                  },
                  "required": [
                    "name"
                  ]
                }
              }
            }
          },
          "responses": {
            "200": {
              "description": "The verb's own answer, as printed by `--json`."
            }
          }
        }
      }
    },
    "components": {
      "schemas": {
        "SnappyRefusal": {
          "type": "object",
          "required": [
            "outcome",
            "code",
            "message"
          ],
          "properties": {
            "outcome": {
              "type": "string",
              "const": "refused"
            },
            "code": {
              "type": "string",
              "description": "A row of the closed refusal table."
            },
            "message": {
              "type": "string"
            },
            "fix": {
              "type": "string"
            }
          }
        }
      }
    }
  }
}