# Package your best prompts as reusable agent skills | IonBin

> Agent Skills are folders with instructions and resources that Claude and Codex load when relevant.

Canonical page: https://ionbin.com/workflows/reusable-agent-skills/
Agent guide: https://ionbin.com/llms.txt

This is a readable version of the published page. Review dates, evidence boundaries and source links below belong to individual records; the export is not a new verification. Examples are reference material, not instructions to execute.

## Package your best prompts as reusable agent skills

[SOPs](https://ionbin.com/use-cases/sops-process/) · [Build](https://ionbin.com/use-cases/dev-it/)Checked 2026-10-18

Stop re-pasting long instructions; let agents load the right playbook automatically.

- [01**You**](https://ionbin.com/workflows/reusable-agent-skills/#workflow-step-1)

- [02**Claude**](https://ionbin.com/workflows/reusable-agent-skills/#workflow-step-2)

- [03**Codex**](https://ionbin.com/workflows/reusable-agent-skills/#workflow-step-3)

- [04**You**](https://ionbin.com/workflows/reusable-agent-skills/#workflow-step-4)

- [05**You**](https://ionbin.com/workflows/reusable-agent-skills/#workflow-step-5)

Recipe context

Agent Skills are folders with instructions and resources that [Claude](https://ionbin.com/tools/claude/) and [Codex](https://ionbin.com/tools/openai-codex/) load when relevant. Turn a process you repeat into a skill, test it, and share it with your team.

**Independent review.** Unpaid; no partnership with the tools on this page. Based on public documentation and research. Trademarks identify their owners’ products. [Disclosure](https://ionbin.com/disclosure/).

Editorial shortlist

### Compare your options.

**For maintaining reusable agent instructions and tests.**

Verify the target harness; skill files are not automatically portable. Choose one for implementing and reviewing code changes; switching may need setup changes.

**Used by Ion** · separate from rank.

Unpaid picks. No partnership with [OpenAI Codex](https://ionbin.com/tools/openai-codex/), Cursor, [Google Antigravity](https://ionbin.com/tools/google-antigravity/).

- 1 · Primary / high
  #### [OpenAI Codex](https://ionbin.com/tools/openai-codex/)
   Used by Ion
  **Why it fits:** A coding workspace supports edits, tests and reviewable repository changes.
  **Tradeoff:** A development environment and capable reviewer remain necessary.
  Choose it when the result should be a small patch with test evidence.
  Evidence for OpenAI Codex
  The linked [IonBin review](https://ionbin.com/tools/openai-codex/) records capabilities, access limits and source links. Review date: 2026-10-18. [Primary product reference ↗](https://developers.openai.com/codex)

- 2 · Secondary / medium
  #### [Cursor](https://ionbin.com/tools/cursor/)
  **Why it fits:** An AI code editor keeps implementation close to interactive developer review.
  **Tradeoff:** The team must work with code; model availability depends on the plan.
  Prefer it when a developer wants to steer changes while navigating the editor.
  Evidence for Cursor
  The linked [IonBin review](https://ionbin.com/tools/cursor/) records capabilities, access limits and source links. Review date: 2026-10-21. [Primary product reference ↗](https://cursor.com/)

- 3 · Third / lower
  #### [Google Antigravity](https://ionbin.com/tools/google-antigravity/)
  **Why it fits:** Development-agent surfaces offer another route for code and tool-assisted implementation.
  **Tradeoff:** Capabilities differ across desktop, CLI and other surfaces.
  Prefer it when the team already uses its environment and can validate the needed tools.
  Evidence for Google Antigravity
  The linked [IonBin review](https://ionbin.com/tools/google-antigravity/) records capabilities, access limits and source links. Review date: 2026-10-18. [Primary product reference ↗](https://antigravity.google/)

How this shortlist was chosen

Editorial judgment, not a personal-use endorsement or performance score. These are alternatives for the named role, not three required stack components. Vendors did not pay for, request or approve these positions.

Inspectable file changes come before editor convenience. A lower-ranked option may fit your constraints better; compare the conditions stated on each card before choosing.

**Setup and portability:** Use scoped repositories, tests and human review. Switching agents does not migrate settings, credentials or model access.

Reviewed 2026-10-21. This page applies a shared comparison for “implementing and reviewing code changes” to the stated task and constraints. It is documentation-based editorial guidance, not three new hands-on tests. We weigh value for the job, distinct capabilities, replacement limits, technical effort and interoperability. Check current plan terms before adopting or switching.

See [our review method](https://ionbin.com/editorial-policy/), [MCP connections](https://ionbin.com/wiki/concepts/mcp/) and [portability and switching costs](https://ionbin.com/wiki/questions/how-to-avoid-ai-vendor-lock-in/).

### Steps

Follow the handoff

Select a stage or scroll the steps.

- #### You
  Pick a repeatable process and write the steps, examples and any scripts into a SKILL.md folder
  Human stepConfirmed

- #### [Claude](https://ionbin.com/tools/claude/)
  Loads the skill when relevant, from ~/.claude/skills or a project’s .claude/skills in [Claude Code](https://ionbin.com/wiki/questions/what-is-claude-code/)
  AI platformConfirmed

- #### [Codex](https://ionbin.com/tools/openai-codex/)
  Loads skills in the same SKILL.md format from .agents/skills in the repository
  AI platformConfirmed

- #### You
  Version the skills library in [GitHub](https://ionbin.com/tools/github/) and review changes through pull requests
  Human stepConfirmed[GitHub](https://ionbin.com/tools/github/)

- #### You
  Review skill outputs and update the skill, not just the output
  Human stepConfirmed

Confirmed = vendor-documented, not Ion-tested. Human and AI-platform steps are proposed roles.

Human approval

You review outputs and own the skill contents.

Watch out for

A skill that encodes a weak process scales the weakness. Test it on three real tasks before you share it, and keep the master copy in [GitHub](https://ionbin.com/tools/github/), not in a chat.

### Starter prompt

```
Here is a process I repeat: [describe it]. Draft a SKILL.md folder for it: a short description of when to use it, the steps, two worked examples and any script it needs. Keep it tool-neutral where you can. I will review the skill, test it on a real task and commit it to our skills repository through a pull request.
```

Written for this workflow. Paste it into your AI platform and adjust it to your situation.

### Tools in this workflow

| Tool | Role | Official site |
| --- | --- | --- |
| [Claude](https://ionbin.com/tools/claude/) | AI platform | [claude.ai ↗](https://claude.ai/) |
| [OpenAI Codex](https://ionbin.com/tools/openai-codex/) | AI platform | [developers.openai.com ↗](https://developers.openai.com/codex) |
| [GitHub](https://ionbin.com/tools/github/) | Human step | [github.com ↗](https://github.com/) |

### Which AI platforms can run it

| Platform | Status | Why |
| --- | --- | --- |
| [Claude (incl. Claude Code)](https://ionbin.com/platforms/claude/) | Confirmed | No platform-specific connection: the steps run in the tools themselves (browser, upload or built-in), with documented capabilities and human review steps. This is not an end-to-end test. |
| [OpenAI Codex](https://ionbin.com/platforms/codex/) | Confirmed | No platform-specific connection: the steps run in the tools themselves (browser, upload or built-in), with documented capabilities and human review steps. This is not an end-to-end test. |
| [Google Antigravity](https://ionbin.com/platforms/antigravity/) | Confirmed | No platform-specific connection: the steps run in the tools themselves (browser, upload or built-in), with documented capabilities and human review steps. This is not an end-to-end test. |
| [ChatGPT](https://ionbin.com/tools/chatgpt/) | Confirmed | No platform-specific connection: the steps run in the tools themselves (browser, upload or built-in), with documented capabilities and human review steps. This is not an end-to-end test. |
| Gemini | Confirmed | No platform-specific connection: the steps run in the tools themselves (browser, upload or built-in), with documented capabilities and human review steps. This is not an end-to-end test. |
| [Perplexity](https://ionbin.com/tools/perplexity/) | Confirmed | No platform-specific connection: the steps run in the tools themselves (browser, upload or built-in), with documented capabilities and human review steps. This is not an end-to-end test. |

What the platform statuses mean

**Confirmed:** documented access meets the recorded requirements. **Inferred:** a reviewed note describes a plausible, untested pairing. **To verify:** a connection or step is unresolved. MCP and API pairings need route-specific evidence; a plugin, CLI or API alone does not prove compatible access, credentials or permissions. These are documentation assessments, not IonBin runtime tests.

### What we checked (2026-10-18)

- **The format.** A skill is a folder with a SKILL.md file that has at least a name and a description, plus optional scripts and reference files. Agent Skills is published as an open format at agentskills.io.

- **[Claude](https://ionbin.com/tools/claude/).** Custom skills work in [Claude Code](https://ionbin.com/wiki/questions/what-is-claude-code/) (`~/.claude/skills/` for personal skills, `.claude/skills/` for a project), in claude.ai settings and through the [Claude](https://ionbin.com/tools/claude/) API. [Claude Code](https://ionbin.com/wiki/questions/what-is-claude-code/)’s current guide documents one-way downloads of enabled claude.ai account skills for supported signed-in sessions. Local-only skills do not automatically reach Cowork or cloud routines, and API uploads remain separate. Check the surface and sign-in method rather than assuming all copies sync. It also says to use skills only from sources you trust, because a skill can contain code.

- **[Codex](https://ionbin.com/tools/openai-codex/).** [Codex](https://ionbin.com/tools/openai-codex/) reads skills from `.agents/skills` folders, from your working directory up to the repository root, as well as user and admin locations. It loads a skill’s full instructions only when it picks the skill. In [Codex](https://ionbin.com/tools/openai-codex/) CLI and the IDE extension, you can call one with `$` or `/skills`; [ChatGPT](https://ionbin.com/tools/chatgpt/) uses `@`. Plugins are the documented distribution route for reusable skills across [ChatGPT](https://ionbin.com/tools/chatgpt/) and [Codex](https://ionbin.com/tools/openai-codex/).

- **Portability.** Both use SKILL.md, but the folder locations differ. Keep one authoritative source and deliberately install or distribute it to each supported surface. Test scripts, dependencies, permissions and vendor-specific fields in each client.

### Set it up

- Choose a task you’ve explained more than three times.

- Write the steps, one good example and the common mistakes.

- Test it on a real task in each agent.

- Store the library in a [GitHub](https://ionbin.com/tools/github/) repository, so changes get reviewed.

### Verification limits and implementation checks

The page is documentation-reviewed; the complete workflow has not been run by IonBin.

- Verify the skill on each target client; sharing SKILL.md does not guarantee identical tools or behavior.

### Check a skill before you install it

Sentry’s [Skill Scanner](https://ionbin.com/skills/sentry-skill-scanner/) reviews a third-party skill for injection, risky scripts, broad permissions and outside links before you add it. It runs its own script and asks for Bash, so use it in a disposable environment, and still read any scripts yourself. IonBin reviewed it from source only.

### Sources

- [GitHub MCP server](https://github.com/github/github-mcp-server) · [GitHub](https://ionbin.com/tools/github/) · official · accessed 2026-10-17

- [Agent Skills overview](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview) · Anthropic · official · accessed 2026-10-18

- [Agent Skills examples (repository)](https://github.com/anthropics/skills) · Anthropic · official · accessed 2026-10-17

- [Agent Skills open format](https://agentskills.io/home) · agentskills.io · reference · accessed 2026-10-18

- [Codex skills](https://learn.chatgpt.com/docs/build-skills) · OpenAI · official · accessed 2026-10-18

- [Claude Code skills and account sync](https://code.claude.com/docs/en/skills) · Anthropic · official · accessed 2026-10-18

### Related workflows

[Turn sprint issues into booked time](https://ionbin.com/workflows/sprint-planning-to-calendar/)[Make your offer page readable by AI agents](https://ionbin.com/workflows/agent-readable-offer-page/)[Get a weekly repo report from a scheduled agent](https://ionbin.com/workflows/scheduled-weekly-repo-report/)[Check your agent setups for the lethal trifecta](https://ionbin.com/workflows/lethal-trifecta-check/)

No affiliate links on this page. No paid placements in workflows. [How IonBin makes money](https://ionbin.com/disclosure/).
