{
  "markdown": "[日本語](README.ja.md)\n\n# esa Skills\n\nA collection of skills for operating [esa](https://esa.io) from AI agents.\n\n## Overview\n\nesa Skills provides skills that let AI agents operate your esa team directly.\nWith natural language instructions, you can search, read, create, and edit posts,\npost comments, browse categories and tags, and manage attachments — all through\nthe [esa CLI](https://www.npmjs.com/package/@esaio/esa-cli).\n\n## Skills\n\n### esa-cli\n\nA skill that enables AI agents to operate esa through the esa CLI.\n\n#### Features\n\n- **Posts** — Search, view, create, update, append/prepend, duplicate, rollback, archive, delete\n- **Comments** — List, view, create, update, delete\n- **Categories** — List paths\n- **Tags / Members / Team** — List, stats\n- **Attachments** — Upload, sign, download\n- **Feedback** — Send feedback to the esa.io team\n- **Escape hatch** — Call any esa API path via `esa api`\n\n#### Usage Examples\n\n```\n\"Search esa for meeting notes\"\n\"Show me post 1234\"\n\"Post today's work log as a WIP to esa\"\n\"Add a comment to post 1234\"\n\"List all tags on esa\"\n```\n\n## Prerequisites\n\n- Claude Code, Cursor, Gemini CLI, or Codex CLI installed\n- Node.js >= 24.18.0 / npm >= 11.7.0\n- [esa CLI](https://www.npmjs.com/package/@esaio/esa-cli) (`@esaio/esa-cli`) installed\n- Authenticated with the esa CLI (`esa auth login`)\n\n### Install the esa CLI\n\n```bash\nnpm install --ignore-scripts -g @esaio/esa-cli\n```\n\n### Authentication\n\n```bash\nesa auth login\n```\n\nBy default this requests every scope the esa CLI commands use. To narrow it down —\nread-only access, for example — pass `--scopes`. Commands that need a scope you did\nnot grant will fail, so log in again when that happens.\n\n```bash\nesa auth login --scopes \"read:post read:comment\"\n```\n\n## Installation\n\n### Claude Code\n\n```\nclaude plugin marketplace add https://github.com/esaio/esa-skills\nclaude plugin install esa@esa-skills\n```\n\n### Codex CLI\n\n```bash\ncodex plugin marketplace add https://github.com/esaio/esa-skills\ncodex plugin add esa@esa-skills\n```\n\n### Cursor Agent\n\n```bash\ncursor-agent plugin marketplace add https://github.com/esaio/esa-skills\n```\n\nThen start `cursor-agent` in interactive mode, open `/plugin`, and install esa\nfrom the Marketplace.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/esaio/esa-skills\n```\n\n### Any agent (GitHub CLI)\n\nThe `gh skill` command installs Agent Skills from GitHub repositories into the\nappropriate directory for each supported agent.\n\n```bash\n# Install for Codex at user scope\ngh skill install esaio/esa-skills esa-cli --agent codex --scope user\n\n# --agent also accepts claude-code, cursor, gemini-cli, and others\n```\n\n`gh skill` is a preview feature, so its commands and behavior may change.\n\n### Any agent (npx skills)\n\n[`npx skills`](https://github.com/vercel-labs/skills) is a cross-agent skills\npackage manager. It installs the `esa-cli` skill into every coding agent it\ndetects with a single command — handy when you use more than one agent, or one\nnot listed above.\n\n```bash\n# Install into all detected agents (project-local)\nnpx skills add esaio/esa-skills\n\n# Target a specific agent\nnpx skills add esaio/esa-skills --agent claude-code\n\n# Install for all your projects\nnpx skills add esaio/esa-skills --global\n```\n\n## Author\n\n[esa LLC](https://esa.io)\n\n## License\n\nMIT\n",
  "bytes": 3315,
  "sha": "d5e3e49d1022c5d50fb4be826784e0f73840a47a254caaf265f19d9b48b3e49f",
  "repo_slug": "esaio/esa-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_esaio_esa_skills_449b964c/readme"
}