Claude + Codex skill format examples

---
name: inspect-api-surface
description: Map public API endpoints and summarize request and response contracts for fast onboarding.
---

# Inspect API Surface

## Use this skill when

- The user asks how an API is structured.
- You need a quick endpoint inventory before implementation.

## Workflow

1. Inspect route modules and routers.
2. List each endpoint with method, path, and auth requirement.
3. Summarize request body and response fields.
4. Call out risky or undocumented areas.

---
name: generate-schema-docs
description: Produce schema documentation from PostgreSQL with repeatable script output.
---

# Generate Schema Docs

## Use this skill when

- The user asks to document a schema or table set.
- You need deterministic output across environments.

## Workflow

1. Run `scripts/explore_schema.py` to fetch schema metadata.
2. Generate markdown table summaries.
3. Add business-facing notes for each table.

## Script

Use `scripts/explore_schema.py` rather than rewriting ad-hoc SQL in every run.

#!/usr/bin/env python3
"""Minimal fixture script for schema exploration skill examples."""

import json


def main() -> None:
    payload = {
        "schema_name": "public",
        "table_count": 2,
        "tables": ["users", "skills"],
    }
    print(json.dumps(payload, indent=2))


if __name__ == "__main__":
    main()

---
name: issue-triage
description: Triage incoming bug reports into actionable implementation tasks.
metadata:
  short-description: Triage bugs into fix plans
---

# Issue Triage

## Use this skill when

- A user sends a bug report and wants a clear execution plan.
- The team needs consistent prioritization and reproduction details.

## Workflow

1. Rephrase the issue in precise technical terms.
2. Identify reproduction steps and probable root cause.
3. Propose fix scope, tests, and rollout risk.

interface:
  display_name: "Rollout Checklist"
  short_description: "Prepare production rollout checklist"
  icon_small: "./assets/rollout-small.svg"
  icon_large: "./assets/rollout-large.svg"