# Skills

This file tells agents how to work with this site.

## Purpose

This site is mostly static. It publishes stories, specs, resumes, and small web tools.

Use this file as the first agent guide for this origin. Use `/.well-known/mcp.json` only when you need structured JSON discovery.

## Public API Rule

If a site has an internet-facing API, publish `/.well-known/skills.md` on that API origin.

This project recommends `github.com/Leopere/autoskill-md` for generating that Markdown file. Other generators may produce the same output. PRs for more language support are welcome.

## Defaults

- Prefer local docs under `/stories/` and `/specs/`.
- Prefer same-origin links and tools.
- Ask before any cross-origin action with side effects.
- Do not put secrets, tokens, or private keys in this file.

## Site Notes

- The agent discovery spec lives at `/specs/skill-discovery.html`.
- The optional JSON example lives at `/.well-known/mcp.json`.
- The source Markdown for the spec lives at `/specs/mcp-discovery.md`.

## Deployment Notes

- If an API lives under a subpath, state the base path once.
- If an API lives on a subdomain, publish a skills file on that subdomain.
- If the main interface is a CLI or repo, keep `SKILLS.md` next to the code.