# Skills and plugins

Source: https://docs.bearletter.com/mcp/skills

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](https://github.com/devxiyang/bearletter-agents):

| File | For |
| --- | --- |
| [/skills/bearletter/SKILL.md](/skills/bearletter/SKILL.md) | The skill itself: one Markdown file. |
| [/skills/bearletter.zip](/skills/bearletter.zip) | The skill as a zip, for apps that take an upload. |
| [/agents.zip](/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](/mcp/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.
