Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buttons.sh/llms.txt

Use this file to discover all available pages before exploring further.

skill.md is a machine-readable file that tells AI agents what your product can do, what inputs it needs, and what constraints apply. While llms.txt is a documentation index and MCP is a search API, skill.md is a capability summary — the agent loads it once and knows how to use Buttons.

​
Install the Buttons skill

npx skills add https://buttons.mintlify.app
This fetches the Buttons skill from the hosted discovery endpoint and installs it into your agent’s skill directory. The skill includes every command, flag, the JSON output contract, argument types, and common usage patterns — all auto-generated from the Cobra command tree.

​
Discovery endpoints

Mintlify hosts the skill at two standard endpoints:
EndpointURL
Agent-skills 0.2.0 (recommended)https://buttons.mintlify.app/.well-known/agent-skills/index.json
Individual skillhttps://buttons.mintlify.app/.well-known/agent-skills/buttons/SKILL.md
Legacy formathttps://buttons.mintlify.app/.well-known/skills/index.json
The agent-skills endpoint includes SHA256 integrity verification so tools can verify the skill hasn’t been tampered with.

​
Manual installation

If you prefer to install the skill manually instead of using npx skills add:
The Buttons skill is already in the repo at .agents/skills/buttons/SKILL.md. Claude Code picks it up automatically when working in the Buttons repo.For other repos, copy the skill:
mkdir -p .agents/skills/buttons
curl -fsSL https://buttons.mintlify.app/.well-known/agent-skills/buttons/SKILL.md \
  -o .agents/skills/buttons/SKILL.md

​
What the skill contains

The Buttons skill is auto-generated from the Cobra command tree via go run ./internal/tools/skillgen. It follows the AgentSkills specification and includes:
  • YAML frontmatter — name, description, license, compatibility, metadata
  • Quick reference — copy-paste examples for create, press, list, history, delete
  • Full command reference — every command and subcommand with flags table
  • JSON output contract — success/error shapes and all error codes
  • Argument types — string, int, bool with env var and template injection rules
  • Button sources — code, HTTP, file, agent with runtime details
  • Common patterns — lifecycle, agent context, local dev server examples
  • Storage layout — ~/.buttons/ directory structure

​
Keeping the skill current

The skill auto-updates through two mechanisms:
  1. In the repo — the docs-sync workflow regenerates SKILL.md whenever CLI code changes on main and opens a PR with updates
  2. On Mintlify — the hosted skill file updates whenever the docs deploy
You never have to manually maintain the skill content. Change a command or flag in cmd/*.go, and the skill updates automatically.

​
skill.md vs llms.txt vs MCP

skill.mdllms.txtMCP server
What it isCapability summaryDocumentation indexReal-time search API
Agent loads itOnce at session startOnce for discoveryOn demand per query
Best forTeaching an agent how to use ButtonsRAG pipelines, embeddingDeep questions, page lookup
Size~300 lines~50 lines (links only)N/A (API)
Installnpx skills add <url>Fetch the URLclaude mcp add