Agent skills

Two skills that teach an agent how BetterFans Link works and how to run common agency jobs. Install them in Claude Code, Claude.ai or any agent that reads SKILL.md files.

A skill is a folder with a SKILL.md file and reference files that an agent loads when a task calls for it. BetterFans Link publishes two. They hold no keys and change nothing on their own. They make an agent that already has the MCP server or an API key use it well.

The two skills

Skill	Teaches the agent
`betterfans-link`	The model of workspaces, accounts, fans and chats, ids, the money rule, freshness, account statuses, approvals for writes, errors and rate limits. Its references list every route, object, error code and MCP tool.
`betterfans-link-workflows`	Step by step plans for a daily briefing, whales and churn, replying to unread paying fans with approval, mass message performance and linking a creator. Each step names the MCP tool and the REST route.

Install both. The workflows skill assumes the first one is loaded.

Skill	Files
`betterfans-link`	SKILL.md, references/api-routes.md, references/errors.md, references/mcp-tools.md, references/objects.md
`betterfans-link-workflows`	SKILL.md, references/daily-briefing.md, references/link-a-creator.md, references/mass-message-performance.md, references/reply-to-paying-fans.md, references/whales-and-churn.md

Claude Code

Claude Code loads skills from ~/.claude/skills for your user and from .claude/skills in a project. This downloads both skills into your user folder.

# Installs for your user. Set dest=.claude/skills to install for one project instead.
dest="$HOME/.claude/skills"
for f in \
  betterfans-link/SKILL.md \
  betterfans-link/references/api-routes.md \
  betterfans-link/references/errors.md \
  betterfans-link/references/mcp-tools.md \
  betterfans-link/references/objects.md \
  betterfans-link-workflows/SKILL.md \
  betterfans-link-workflows/references/daily-briefing.md \
  betterfans-link-workflows/references/link-a-creator.md \
  betterfans-link-workflows/references/mass-message-performance.md \
  betterfans-link-workflows/references/reply-to-paying-fans.md \
  betterfans-link-workflows/references/whales-and-churn.md; do
  curl -fsSL --create-dirs -o "$dest/$f" "https://app.betterfans.link/skills/$f"
done

Start a new Claude Code session and ask something like "Give me a daily briefing for all my creators". Claude Code picks the skill up from its description. Run the same command again to update the skills.

Claude.ai and Claude Desktop

Claude.ai and Claude Desktop take a skill as a zip file with the skill folder inside. Download the skills with the command above, then zip each folder.

cd "$HOME/.claude/skills"
zip -r betterfans-link.zip betterfans-link
zip -r betterfans-link-workflows.zip betterfans-link-workflows

Upload both zips in the Skills section of Claude's settings. Connect the MCP server as a custom connector too, as shown in client setup, so the skills have tools to call.

Other agents

The skills are plain markdown, so any agent can use them.

If your agent reads SKILL.md folders, download the files with the command above and set dest to the folder your agent reads.
If it does not, add the text of both SKILL.md files to its instructions, and give it the reference file URLs so it can fetch them when it needs a detail.

What the MCP server already says

The MCP server sends short instructions to every client when it connects. They cover the same core rules: money in cents, gross and net, freshness, fan-written text and approvals. The skills go further, with the reasons behind the rules, full reference tables and the workflows.

Docs for agents

Agents can also read these docs directly.

URL	What it returns
`/llms.txt`	A short index of every docs page with its markdown link.
`/llms-full.txt`	Every docs page in one markdown file.
`/llms.mdx/<slug>`	One page as markdown, such as `/llms.mdx/concepts/money`.
`/docs-index.json`	Every page's slug, title, description, URL and headings as JSON.

Over MCP, the search_docs and get_doc tools and the bfl://docs/{slug} resources read the same pages.