Use One Skill Set Across Claude Code and Other Agents
Make a single skills folder serve every agent tool you use.
~7 min read
Since Agent Skills was published as an open standard (December 2025, at agentskills.io), the same SKILL.md format is read by a growing list of agent products: Claude Code and claude.ai, plus tools from other vendors including OpenAI Codex, GitHub Copilot, Cursor, and more. Practically, that means a skill is no longer tied to the tool it was written in. Here is how to actually get that portability.
Keep one canonical skills repo
Maintain your skills in a single version-controlled folder: one directory per skill, SKILL.md inside each. This repo is the source of truth; every tool gets its skills from here, never by hand-editing an installed copy.
my-skills/
release-line/SKILL.md
bug-triage/SKILL.md
deploy-checklist/
SKILL.md
scripts/verify.pyWrite for portability
- Reference bundled files by relative path only, never a machine-specific absolute path.
- State prerequisites explicitly in the body (tools, credentials, services) so a new environment can meet them instead of guessing.
- Keep bundled scripts self-contained (standard library only, no install step) so they run wherever the skill lands.
- Do not lean on one tool’s private features in the core instructions; if a step is tool-specific, label it as such so other agents can skip it gracefully.
Install per tool, verify per tool
Each agent has its own skills location and install mechanism: a directory to copy into, a plugin system, or a config pointer. The portable part is the skill itself; the wiring is per-tool. After wiring each tool, run the same two-prompt check: one request that should trigger the skill, one near-miss that should not.