# Tooling index

This file keeps low-frequency script references out of `SKILL.md` while preserving package-level traceability for orphan-file audits.

## Repo surface and naming

- `scripts/audit_repo_discovery.py`: checks repo-level README, discovery entry points, representative skills, and install surfaces.
- `scripts/check_skill_name_surface.py`: checks slug, slash-command, description, trigger phrase, and command-prefix risks.
- `scripts/generate_catalog.py`: generates a repo-level catalog from local skill metadata.

## Reports and examples

- `scripts/generate_report.py`: renders the description-optimization report.
- `scripts/run_example_tests.py`: validates `examples/*/input.md` and `expected_properties.json` fixtures when outputs exist.
- `scripts/run_composition_tests.py`: checks portfolio-level composition fixtures and handoff chains.

## Schemas and helpers

- `scripts/validate_skill_spec.py`: validates `skill_spec.yaml` against required use-case fields.
- `scripts/utils.py`: shared `SKILL.md`, JSON, and frontmatter helpers used by audit and release scripts.