Websites skill for AI agents
The websites skill teaches Claude Code, Cursor, Codex and other coding agents to build and manage websites for local businesses with ShowFirst: build one website, make preview sites for a whole list or search, check builds, change a finished website and make Online Presence Report links. It is one Markdown file. The agent reads it and then uses the Websites API or the MCP server.
The skill tells the agent to show you what a build will cost and to wait for your yes before it starts anything.
The file
https://showfirst.app/docs/skills/websites/SKILL.md
Before you start
Make an API key: open API Keys in your dashboard, type a name in the Key label box, and click + Create New Key. Put it in an environment variable where your agent runs:
export SHOWFIRST_API_KEY=sf_live_your_key
Claude Code
Save the skill into your skills folder. Claude Code picks it up the next time it starts.
mkdir -p ~/.claude/skills/showfirst-websites
curl -s https://showfirst.app/docs/skills/websites/SKILL.md \
-o ~/.claude/skills/showfirst-websites/SKILL.md
Connect the MCP server too, so the agent can change finished websites:
claude mcp add --transport http showfirst https://showfirst.app/api/mcp \
--header "Authorization: Bearer $SHOWFIRST_API_KEY"
Cursor
Save the file as a project rule:
mkdir -p .cursor/rules
curl -s https://showfirst.app/docs/skills/websites/SKILL.md -o .cursor/rules/showfirst-websites.mdc
Codex and other agents
Save the file in your project and point the agent at it, for example from AGENTS.md:
curl -s https://showfirst.app/docs/skills/websites/SKILL.md -o docs/showfirst-websites.md
echo "For building websites for local businesses with ShowFirst, follow docs/showfirst-websites.md." >> AGENTS.md
Try it
Ask your agent something like:
From my roofer search in Sarasota, make preview sites for every roofer with no website, then give me the spreadsheet of preview links.
The agent plans the batch, tells you what it costs, and starts once you say yes. Then it waits for the previews and saves the file.
What it covers
- Setup, your key and what each thing costs.
- One website: from your own details, from a search or from Google; plan, confirm, check.
- Preview batches from a list or a search: plan, confirm, preview links, restyle, fix one, export.
- Online Presence Report links to pitch with.
- Changing a finished website and undoing changes.
- What each error means.