Agents (MCP)
Skills and plugins
The Bearletter skill and plugin, which add the MCP server and teach your agent how Bearletter works.
The MCP server alone is enough to work on your blog. The Bearletter skill adds the blog's rules and the usual ways of doing things (preview before publishing, the fixed file names, drafts and unpublished changes), so the agent gets them right the first time.
The skill and the plugin are served here, and mirrored on GitHub at devxiyang/bearletter-agents:
| File | For |
|---|---|
| /skills/bearletter/SKILL.md | The skill itself: one Markdown file. |
| /skills/bearletter.zip | The skill as a zip, for apps that take an upload. |
| /agents.zip | The whole plugin folder: the skill plus the MCP server for Claude Code, Codex and Gemini CLI. |
The prompt on the home page asks your agent to install the skill when it can.
Install#
| Agent | How |
|---|---|
| Any agent with skills | Save https://docs.bearletter.com/skills/bearletter/SKILL.md as bearletter/SKILL.md in its skills folder (many read .agents/skills/; Claude Code reads .claude/skills/), and add the MCP server (Connect). |
| Claude Code | /plugin marketplace add devxiyang/bearletter-agents, then /plugin install bearletter@bearletter, which adds the MCP server and the skill. Without GitHub: unzip /agents.zip and run /plugin marketplace add ./bearletter-agents. |
| Gemini CLI | gemini extensions install https://github.com/devxiyang/bearletter-agents, or unzip /agents.zip and install that folder. |
| Codex | Install the plugin folder from /agents.zip (it has plugin.json, mcp.json and skills/). |
| Claude (web and desktop) | Upload /skills/bearletter.zip under Customize › Skills, and add the MCP server as a connector. |
The skill is under the MIT license.
Bearletter · bearletter.com · Every page is also Markdown: llms.txt