Skip to content
Back to search

mercury-agent-skills

A curated registry of reusable Mercury Agent, Open Claw or Hermes Agent skills designed for real developer workflows, persistent memory, and token-efficient execution.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cosmicstack-labs--mercury-agent-skills/badge.svg)](/listings/cosmicstack-labs--mercury-agent-skills)

HTML

<a href="/listings/cosmicstack-labs--mercury-agent-skills"><img src="/api/listings/cosmicstack-labs--mercury-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

From the Mercury CLI (recommended)

# List what's available
mercury skills search "react patterns"

# Install one skill
mercury skills install frontend/react-patterns

# Install several at once
mercury skills install ai-ml/prompt-engineering devops/docker security/threat-modeling

Installed skills land in `~/.mercury/skills/<category>/<slug>/SKILL.md` and are picked up automatically by your agent.

From the web

Open [**skills.mercuryagent.sh**](https://skills.mercuryagent.sh), pick a skill, copy the install line for your agent — every skill page ships ready-made install steps for Mercury, Claude Code, Codex, OpenClaw, Hermes, and "any other agent that understands SKILL.md".

Clone the whole library

git clone https://github.com/cosmicstack-labs/mercury-agent-skills.git

Drop individual skills into your agent's skills directory:

| Agent | Skills directory | |---|---| | **Mercury** | `~/.mercury/skills/` | | **Claude Code** | `.claude/skills/` | | **Codex CLI** | `.codex/skills/` | | **OpenClaw** | `.openclaw/skills/` | | **Hermes** | `.hermes/skills/` | | **Cursor** | `.cursor/skills/` | | **Gemini CLI** | `.gemini/skills/` | | Any other | Wherever your agent reads `SKILL.md` from |

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 199 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Mercury Skills
  2. <p align="center">
  3. <img src="assets/mercury-agent-skills-card.png" alt="Mercury Skills" width="75%" style="max-width: 700px; height: auto;">
  4. </p>
  5. <p align="center">
  6. <a href="https://skills.mercuryagent.sh"><strong>Browse the registry</strong></a> •
  7. <a href="https://mercuryagent.sh"><strong>Mercury Agent</strong></a> •
  8. <a href="./CATALOG.md"><strong>Catalog</strong></a> •
  9. <a href="./CONTRIBUTING.md"><strong>Contribute</strong></a>
  10. </p>
  11. **An open-source library of `SKILL.md` playbooks for AI agents.** Browse and install on [skills.mercuryagent.sh](https://skills.mercuryagent.sh), or pull them directly from the [Mercury Agent](https://mercuryagent.sh) CLI.
  12. **132 skills across 23 categories** — hand-curated, production-ready, and compatible with every major agent: Mercury, Claude Code, Codex CLI, OpenClaw, Hermes, Cursor, and Gemini CLI.
  13. ---
  14. ## Quick Start
  15. ### From the Mercury CLI (recommended)
  16. ```bash
  17. # List what's available
  18. mercury skills search "react patterns"
  19. # Install one skill
  20. mercury skills install frontend/react-patterns
  21. # Install several at once
  22. mercury skills install ai-ml/prompt-engineering devops/docker security/threat-modeling
  23. ```
  24. Installed skills land in `~/.mercury/skills/<category>/<slug>/SKILL.md` and are picked up automatically by your agent.
  25. ### From the web
  26. Open [**skills.mercuryagent.sh**](https://skills.mercuryagent.sh), pick a skill, copy the install line for your agent — every skill page ships ready-made install steps for Mercury, Claude Code, Codex, OpenClaw, Hermes, and "any other agent that understands SKILL.md".
  27. ### Clone the whole library
  28. ```bash
  29. git clone https://github.com/cosmicstack-labs/mercury-agent-skills.git
  30. ```
  31. Drop individual skills into your agent's skills directory:
  32. | Agent | Skills directory |
  33. |---|---|
  34. | **Mercury** | `~/.mercury/skills/` |
  35. | **Claude Code** | `.claude/skills/` |
  36. | **Codex CLI** | `.codex/skills/` |
  37. | **OpenClaw** | `.openclaw/skills/` |
  38. | **Hermes** | `.hermes/skills/` |
  39. | **Cursor** | `.cursor/skills/` |
  40. | **Gemini CLI** | `.gemini/skills/` |
  41. | Any other | Wherever your agent reads `SKILL.md` from |
  42. ---
  43. ## Why Mercury Skills?
  44. | | |
  45. |---|---|
  46. | **Curated, not crowded** | Every skill is hand-written against real workflows — no AI slop, no duplicates. |
  47. | **Universal format** | One `SKILL.md` works in any agent that supports the standard. No per-agent forks. |
  48. | **Discoverable** | Full-text search, categories, tags, leaderboard, and live JSON feed on [skills.mercuryagent.sh](https://skills.mercuryagent.sh). |
  49. | **Installable** | One CLI command, no manual file copying. Atomic writes, version pinning, rollback on failure. |
  50. | **Open** | MIT licensed. Contributions welcome via PR — see [CONTRIBUTING.md](./CONTRIBUTING.md). |
  51. ---
  52. ## Browse on the Web
  53. [**skills.mercuryagent.sh**](https://skills.mercuryagent.sh) is the canonical browse-and-install surface for the library. It serves:
  54. - A searchable, categorized index of every skill in this repo
  55. - A trending leaderboard ranked by likes and installs
  56. - Per-skill detail pages with the full `SKILL.md`, install steps for every supported agent, and a copy-paste-ready install command
  57. - A bookmarking system so you can save skills for later (local, no account required)
  58. - Social share cards with per-skill OpenGraph imagery
  59. It also exposes a public JSON feed at [`/api/feed.json`](https://skills.mercuryagent.sh/api/feed.json) and per-skill JSON at `/api/skills/<category>/<slug>` for tooling builders.
  60. ---
  61. ## Categories
  62. | Category | Skills | What's inside |
  63. |---|---|---|
  64. | [Development](./categories/development/) | 16 | Clean code, code review, debugging, testing, ADRs, documentation, refactoring, dependency hygiene |
  65. | [AI & ML](./categories/ai-ml/) | 11 | Prompt engineering, agent health, memory, delegation, handoffs, token budgets, error recovery, audit logging |
  66. | [Backend](./categories/backend/) | 9 | APIs, Node.js, Python, database design, auth, serverless, microservices, caching, message queues |
  67. | [Shop & Restaurant](./categories/shop-restaurant/) | 10 | Inventory, menu engineering, scheduling, reviews, daily pulse, table management, pricing, social, Zomato ordering, Amazon assistant (search/cart/orders/insights) |
  68. | [Frontend](./categories/frontend/) | 8 | React, Next.js, Tailwind, state management, testing, performance, responsive design, component systems |
  69. | [Creative & Personal Development](./categories/creative-personal-development/) | 8 | Storytelling, decision frameworks, standups, notes, repurposing, branding, validation, time blocking |
  70. | [DevOps](./categories/devops/) | 7 | Docker, CI/CD, Kubernetes, Terraform, monitoring, SRE, GitOps |
  71. | [Career](./categories/career/) | 5 | Resume writing, interview prep, career planning, LinkedIn, salary negotiation |
  72. | [Education & Learning](./categories/education-learning/) | 5 | Curriculum design, learning science, teaching methods, assessment, micro-learning |
  73. | [Finance & Legal](./categories/finance-legal/) | 5 | Financial analysis, budgeting, contracts, privacy compliance, risk management |
  74. | [Health & Wellness](./categories/health-wellness/) | 5 | Fitness, nutrition, mental health, sleep, habits |
  75. | [Mobile](./categories/mobile/) | 5 | iOS, Android, React Native, performance, App Store optimization |
  76. | [Testing & QA](./categories/testing-qa/) | 5 | Test strategy, E2E, performance testing, API testing, accessibility testing |
  77. | [Automation](./categories/automation/) | 11 | Screenshots, workflows, shell scripting, web scraping, X/Twitter automation, twitter-account-manager (research), test automation, data sync, deployment automation, RPA, daily briefing |
  78. | [Media Download](./categories/media-download/) | 6 | yt-dlp wrappers, audio extraction, batch downloading, platform-specific patterns, GitHub repo promo videos, GitHub repo scrolling tours |
  79. | [PDF Generation](./categories/pdf-generation/) | 5 | Invoices, reports, branded documents, dynamic templating, markdown→PDF typesetting (any2pdf) |
  80. | [Presentation](./categories/presentation/) | 4 | Slide decks, narrative structure, stage delivery, visual hierarchy |
  81. | [Marketing](./categories/marketing/) | 3 | SEO, content strategy, distribution |
  82. | [Business](./categories/business/) | 2 | Negotiation, operations |
  83. | [Design](./categories/design/) | 2 | UI systems, accessibility |
  84. | [Product](./categories/product/) | 2 | Strategy, discovery |
  85. | [Security](./categories/security/) | 2 | Audit, secure coding |
  86. | [Data](./categories/data/) | 1 | Data engineering fundamentals |
  87. See [CATALOG.md](./CATALOG.md) for the full skill-by-skill index.
  88. ---
  89. ## Skill Structure
  90. Every skill is a single `SKILL.md` file with YAML frontmatter and a markdown body:
  91. ```yaml
  92. ---
  93. name: skill-name
  94. description: 'What this skill does and when to use it'
  95. metadata:
  96. author: cosmicstack-labs
  97. version: 1.0.0
  98. category: development
  99. tags: [clean-code, refactoring, best-practices]
  100. ---
  101. # Skill Name
  102. Full instructions, frameworks, scoring rubrics, and actionable guidance.
  103. ```
  104. The format is intentionally minimal so any agent runtime can parse it without custom tooling. See [CONTRIBUTING.md](./CONTRIBUTING.md) for the authoring standard.
  105. ---
  106. ## Try Mercury Agent
  107. These skills are built for [**Mercury Agent**](https://mercuryagent.sh) — the agent runtime that consumes them natively.
  108. - **Second Brain** — persistent memory that learns from every session
  109. - **Skill system** — load, version, and update skills from this registry directly
  110. - **Permission guardrails** — safe by design, auditable by default
  111. - **Token budgets** — keep AI spend predictable
  112. - **Multi-channel** — CLI, Telegram, and web; same agent, same memory
  113. ```bash
  114. # Install Mercury Agent
  115. npm install -g @cosmicstack/mercury-agent
  116. # Pull a skill into your agent
  117. mercury skills install ai-ml/prompt-engineering
  118. # Browse what you have
  119. mercury skills list
  120. ```
  121. [**Get started with Mercury →**](https://mercuryagent.sh)
  122. ---
  123. ## Ecosystem
  124. | Project | What it is |
  125. |---|---|
  126. | [**Mercury Agent**](https://mercuryagent.sh) | The agent runtime — CLI, Telegram, web — that loads these skills |
  127. | [**Mercury Skills (this repo)**](https://github.com/cosmicstack-labs/mercury-agent-skills) | The curated `SKILL.md` library |
  128. | [**skills.mercuryagent.sh**](https://skills.mercuryagent.sh) | The browse-and-install web platform powered by this repo |
  129. Built and maintained by [Cosmic Stack](https://cosmicstack.org).
  130. ---
  131. ## Contributing
  132. We accept new skills, fixes, and refinements via pull request.
  133. - **Author a skill** — see the standard in [CONTRIBUTING.md](./CONTRIBUTING.md)
  134. - **Fix or improve an existing skill** — open a PR with a clear changelog note
  135. - **Request a category** — open an issue with the proposed scope
  136. Every merged contribution lands on [skills.mercuryagent.sh](https://skills.mercuryagent.sh) within the hour via an automated sync.
  137. ---
  138. ## License
  139. MIT — see [LICENSE](./LICENSE).
  140. <p align="center">
  141. <sub>Built by <a href="https://cosmicstack.org">Cosmic Stack</a> · Powered by <a href="https://mercuryagent.sh">Mercury Agent</a></sub>
  142. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.