ONLINEAGENT_OPS 2026.Q3 HOME HUBSMODELSBUILDINGCOMPANIESFILMMAKINGSECURITYLIVING WITH ITSKILLSALL HUBS, ONE TERMINAL → ARTICLES CRAFT RECORD BLOG TOOLS SKILLS SEARCH /
HOME›AI SKILLS›HOW TO INSTALL AI SKILLS IN CLAUDE AND OTHER AI
AI SKILLS · HOW-TOBEGINNER

How to Install AI Skills in Claude and Other AI Apps

Install a skill in the Claude apps or Claude Code, see where Codex, Copilot, Gemini CLI and Cursor look for skills, run five safety checks and remove one.

READ11 min
WORDS2,277
SECTIONS9
TYPEHOW-TO
CHECKED13 OCT 26

To install a skill in the Claude apps, switch on code execution, then go to Customize > Skills and upload the skill’s folder as a ZIP file. In Claude Code, put the folder in a skills folder or install a plugin that contains it.

Other AI apps read the same kind of folder. Whatever the app, read every file in a skill first.

TL;DR — THE SHORT VERSION
  • Claude apps: Settings > Capabilities, turn on code execution, then Customize > Skills, “+”, “Create skill”, “Upload a skill”.
  • Claude Code: copy the folder into ~/.claude/skills/ or a project’s .claude/skills/, or install it as a plugin with /plugin.
  • Other apps: most also read a shared .agents/skills/ folder, so one skill can work in several tools.
  • Check first: official source, every file read, no surprise web addresses, the tool permissions, and the licence.
  • To remove one: delete it in Customize > Skills, delete its folder, or uninstall its plugin.
◈ IN PLAIN TERMS

A skill is a recipe card for an AI assistant. Installing it means putting the card in the right drawer: the assistant reads each card’s title and pulls out the whole card only when you ask for that dish. Some cards come with a script (a small program) the assistant may run, so read the card before it goes in the drawer.

Before you start: what you are installing

The plain point: every skill is a folder with one required file, SKILL.md, plus optional scripts and reference files.

Anthropic, which makes Claude, calls skills “folders that include instructions, scripts, and resources that Claude can load when needed.”1 Since 18 December 2025 the format has been an open standard, so other apps can read it too.2 More in what is a skill in AI?

Three words you will meet below. A repo (repository) is a project folder hosted on a site such as GitHub, where you can read every file first; see repos explained. A terminal is the text window where you type commands, and a tool used there is a CLI (command-line interface). A plugin is a bundle that can hold several skills plus other parts; see skills vs MCP vs plugins.

First: five checks before you install any skill

The plain point: a skill can make the AI run code, so treat it like software. Anthropic’s docs: “Use Skills only from trusted sources: those you created yourself or obtained from Anthropic.”3 Five checks:

  1. Install from the official repo only. Get the skill from the maker’s own page or repo, not a copy re-uploaded by someone else. Claude’s help centre adds that a skill “shared by a colleague” still needs reviewing.4
  2. Read SKILL.md and every script. Anthropic’s checklist is to review “all files bundled in the Skill: SKILL.md, scripts, images, and other resources.”3
  3. Look for web addresses and downloads. The same docs warn that “Skills that fetch data from external URLs pose particular risk”, and that a trusted skill can turn bad if what it downloads changes later.3
  4. Check what it is allowed to do. In Claude Code a skill can list tools it may use without asking you (the allowed-tools line). The docs warn: “A skill can grant itself broad tool access”.5
  5. Check the licence, and switch telemetry off. A licence is the legal permission to use something; read the skill’s own LICENSE file, because Claude Code “accepts the field but doesn’t act on it”.6 Telemetry is usage data a tool sends back to its maker; if the README gives an off switch, this site’s advice is to use it. This is not legal advice.

The one-page checklist before installing a skill has these as a printable list, and skills are a supply chain covers what security researchers found in public skill stores.

TAKEAWAY

Read it, then install it. Official source, every file read, no surprise downloads, sensible permissions, a licence that fits your use.

How to install a skill in the Claude apps

The plain point: switch on code execution once, then upload the skill as a ZIP file under Customize > Skills. These steps are from Claude’s help centre.4

  1. Turn on code execution. Go to Settings > Capabilities and switch on Code execution and file creation. Skills will not show without it.
  2. Make a ZIP file (one compressed file holding a folder). Zip the skill’s folder itself, not its loose files, and name the folder after the skill.7
  3. Open Customize > Skills. Click +, then + Create skill, then Upload a skill, and choose your ZIP.
  4. Switch it on. Claude then uses it when a request matches.

On Team and Enterprise plans, an owner switches skills on under Organization settings > Plugins & skills; on Team plans they start on.4 If an upload fails, the help centre’s list of usual causes includes a folder name that does not match the skill name and a missing skill.md file.8

Two Anthropic pages disagree. The developer docs still say to upload skills “through Settings > Features”; the help centre now says Customize > Skills.3 The help centre caps a description at 200 characters; the docs allow 1,024.9 In this site’s reading the help centre is newer, so follow its menus and keep descriptions under 200 characters.

Which Claude plans can use skills?

The plain point: every plan, including Free, per the help centre; plugins need a paid plan.

The help centre says: “Skills are available for users on Free, Pro, Max, Team, and Enterprise plans. This feature requires code execution to be enabled.”4 That is wider than at launch, when Anthropic wrote that skills were “available to Pro, Max, Team and Enterprise users.”1 This site found no date for when Free was added. Plugins are different: the help centre says they “are available to all paid plans”.10

TAKEAWAY

In the Claude apps: code execution on, Customize > Skills, upload a ZIP that holds the skill folder. If your screen does not match, trust the help centre over the developer docs.

How to install a skill in Claude Code

The plain point: Claude Code, Anthropic’s coding assistant that runs in a terminal, needs no upload. You put the folder in a skills folder, or you install a plugin.

There are two folders to choose from. The Claude Code docs list them like this:5

  • Just for you, in every project: ~/.claude/skills/<skill-name>/. The ~ means your home folder. Folders whose names start with a dot can be hidden in your file browser, so you may need to show hidden files.
  • For one project and everyone working on it: .claude/skills/<skill-name>/ inside that project.

Copy the whole folder in, SKILL.md at the top. Claude Code picks it up without a restart, uses it when a request matches, and lets you call it by name with a slash, such as /skill-name.5

Installing skills as a plugin. Many skills come packed in plugins, which you get from a marketplace: a catalogue of plugins. Claude Code adds Anthropic’s official marketplace for you the first time you start it.11 Anthropic’s own example skills repo gives these commands, typed inside Claude Code, one at a time:12

INSTALL · CLAUDE CODE · STEP 1: ADD ANTHROPIC’S SKILLS MARKETPLACE
/plugin marketplace add anthropics/skills
INSTALL · CLAUDE CODE · STEP 2: THE DOCUMENT SKILLS (WORD, EXCEL, POWERPOINT, PDF)
/plugin install document-skills@anthropic-agent-skills

The same README says these skills are “provided for demonstration and educational purposes only.”12 A plugin can do more than a plain skill folder. The plugin security page warns: “A Claude Code plugin you install can execute arbitrary code on your machine with your user privileges.”13 Run the five checks on a plugin too.

Skills from your Claude account. Skills switched on in the Claude apps also load in Claude Code (version 2.1.273 or later) when you sign in with the same account. The copy goes one way only: Claude Code never changes your account.4

TAKEAWAY

Claude Code: drop the folder into ~/.claude/skills/ or the project’s .claude/skills/, or install a plugin with /plugin. A plugin can run code, so check it like software.

How to install skills in Codex, GitHub Copilot, Gemini CLI and Cursor

The plain point: each app reads skill folders from its own places, and most also read a shared .agents/skills/ folder.

All four added skills between December 2025 and January 2026, around the time the open standard was published, according to their own changelogs. Each one’s docs list where it looks today.

Where other AI apps look for skills
AppSinceWhere to put a skill
Codex (OpenAI)Since: 19 Dec 2025.14Where: $HOME/.agents/skills for you, or .agents/skills in a project. Codex’s built-in $skill-installer can fetch curated skills.15
GitHub CopilotSince: 18 Dec 2025.16Where: .github/skills, .claude/skills or .agents/skills in a project, or ~/.copilot/skills or ~/.agents/skills for you. GitHub’s own CLI has a gh skill command to find and install them.17
Gemini CLI (Google)Since: January 2026 (versions 0.24 to 0.26).18Where: ~/.gemini/skills/ or ~/.agents/skills/ for you, .gemini/skills/ or .agents/skills/ in a project. It asks you to confirm before a skill is used.19
CursorSince: 22 Jan 2026 (Cursor 2.4).20Where: .cursor/skills/ or .agents/skills/ in a project, ~/.cursor/skills/ or ~/.agents/skills/ for you. It also reads Claude’s and Codex’s skill folders.21

Gemini CLI can also install a skill from a repo with gemini skills install and the repo’s address. Its docs’ example adds --consent, which the docs say will “Acknowledge security risks and skip the interactive confirmation during installation.”22 This site’s advice: leave that flag off, so you still see the warning.

One folder for several apps. Codex, Copilot, Gemini CLI and Cursor all read .agents/skills/, so a skill placed there can serve all four; Gemini’s docs call it a path that works “across different AI tools.”19 Claude Code uses its own .claude/skills/ folder, which Copilot and Cursor read too.

How to remove a skill

The plain point: switch it off to keep it for later; delete it to remove it.

  • Claude apps: in Customize > Skills, open the skill and use the switch to turn it off. To delete it, click … next to the switch, choose Delete, and confirm.4
  • Claude Code: delete the skill’s folder, or uninstall its plugin from the /plugin menu. A skill synced from your Claude account must be turned off in the Claude apps; deleting its folder by hand does not stick.23
  • Codex: its docs show how to switch a skill off in Codex’s settings file without deleting it.15
  • Gemini CLI: /skills disable and the skill’s name in a session, or gemini skills uninstall in the terminal.19
TAKEAWAY

Delete it in the app, delete its folder, or uninstall its plugin.

Questions people ask

Do I need to know how to code to install a skill?

No. In the Claude apps you upload a ZIP file from a menu. SKILL.md is plain text you can read; in this site’s view, a script you cannot follow is a reason to ask someone or skip the skill.

Can one skill work in both Claude and ChatGPT?

Often, yes, because both follow the open standard; OpenAI’s docs say ChatGPT and Codex skills “build on the open agent skills standard.”15 A skill can still rely on features one app has and another lacks, so test it in each.

Why is Claude not using my skill?

Check it is switched on in Customize > Skills, that its description says clearly when to use it, and try naming it in your request. Those are the help centre’s own fixes.24

Where to go next

QUICK CHECK · 3 QUESTIONS

Pick an answer to see if you got it. Nothing is recorded.

1. In the Claude apps, what must be switched on before you can use skills?

  • Code execution and file creation
  • Web search
  • Memory across chats
Show the answer

Answer: Code execution and file creation. The page says to switch on Code execution and file creation in Settings > Capabilities first; skills need it to work.

2. Where do you put a skill so Claude Code can use it in all your projects?

  • In the project’s README file
  • In ~/.claude/skills/ in your home folder
  • In a ZIP file on your desktop
Show the answer

Answer: In ~/.claude/skills/ in your home folder. The page says ~/.claude/skills/ is the personal folder that Claude Code reads in every project on your computer.

3. Which of these is one of the page’s five checks before installing a skill?

  • Make sure it has a logo
  • Check how many people liked it
  • Read SKILL.md and every script in it
Show the answer

Answer: Read SKILL.md and every script in it. The page’s second check is to read SKILL.md and every bundled file, because a skill can make the AI run code.

SOURCES
  1. 1Anthropic, Introducing Agent Skills, 16 Oct 2025, read at source 13 Oct 2026“Skills are folders that include instructions, scripts, and resources that Claude can load when needed.” ↑a“Skills are available to Pro, Max, Team and Enterprise users.” ↑b
  2. 2Anthropic, Skills for organizations, partners, the ecosystem, 18 Dec 2025, read at source 13 Oct 2026“We’re also publishing Agent Skills as an open standard. Like MCP, we believe skills should be portable across tools and platforms” ↑
  3. 3Anthropic, Agent Skills (Claude developer docs), read at source 13 Oct 2026“Use Skills only from trusted sources: those you created yourself or obtained from Anthropic.” and “Treat like installing software” ↑a“Review all files bundled in the Skill: SKILL.md, scripts, images, and other resources.” ↑b“Skills that fetch data from external URLs pose particular risk, as fetched content may contain malicious instructions. Even trustworthy Skills can be compromised if their external dependencies change over time” ↑c“Custom Skills: Upload your own Skills as zip files through Settings > Features. Available on Pro, Max, Team, and Enterprise plans with code execution enabled.” ↑d
  4. 4Claude Help Center, Use skills in Claude, read at source 13 Oct 2026“When installing a skill from a less-trusted source—including one shared by a colleague—review it before enabling.” ↑a“Navigate to Settings > Capabilities and ensure that Code execution and file creation is enabled.”; “Package your skill folder as a ZIP file.”; “To add custom skills, click the “+” button, then “+ Create skill.””; “Select “Upload a skill.””; “Upload a ZIP file containing your skill folder.” ↑b“For Team plans: This feature is enabled by default at the organization level.” ↑c“Skills are available for users on Free, Pro, Max, Team, and Enterprise plans. This feature requires code execution to be enabled.” ↑d“It needs Claude Code v2.1.273 or later.” and “The sync is one-way. It reads from your Claude account and never changes anything in it.” ↑e“Use the toggle in the upper right corner to disable the skill.” and “To delete the custom skill entirely, click the “...” button next to the toggle, then select “Delete”” ↑f
  5. 5Claude Code Docs, Extend Claude with skills, read at source 13 Oct 2026“A skill can grant itself broad tool access, so review the allowed-tools of skills checked into a repository before you run Claude Code there.” ↑apersonal, “~/.claude/skills/<skill-name>/SKILL.md”, “All your projects on this machine, but not Cowork or cloud sessions”; project, “.claude/skills/<skill-name>/SKILL.md”, “Sessions in this repository. Commit it so your team gets it too” ↑b“Claude uses skills when relevant, or you can invoke one directly with /skill-name.” and, for ~/.claude/skills/ and the project .claude/skills/, “Claude Code picks up the change within the current session, without a restart.” ↑c
  6. 6Claude Code Docs, Extend Claude with skills, read at source 13 Oct 2026, on the license field“Claude Code accepts the field but doesn’t act on it.” ↑
  7. 7Claude Help Center, How to create custom skills, 22 Jul 2026, read at source 13 Oct 2026“Ensure the folder name matches your skill’s name.” and “The ZIP should contain the skill folder as its root (not a subfolder).” ↑
  8. 8Claude Help Center, Use skills in Claude, read at source 13 Oct 2026, upload errors“Skill folder name doesn’t match the skill name” and “Missing required skill.md file” ↑
  9. 9Claude Help Center, How to create custom skills, 22 Jul 2026, read at source 13 Oct 2026, on the description“This is critical—Claude uses this to determine when to invoke your skill (200 characters maximum).” ↑
  10. 10Claude Help Center, Use plugins in Claude, read at source 13 Oct 2026“Plugins are available to all paid plans (Pro, Max, Team, Enterprise).” ↑
  11. 11Claude Code Docs, Install and manage plugins, read at source 13 Oct 2026“Claude Code adds Anthropic’s official marketplace for you the first time you start an interactive terminal session” ↑
  12. 12Anthropic, anthropics/skills README, read at source 13 Oct 2026“You can register this repository as a Claude Code Plugin marketplace by running the following command in Claude Code:” /plugin marketplace add anthropics/skills; then /plugin install document-skills@anthropic-agent-skills or /plugin install example-skills@anthropic-agent-skills. ↑a“These skills are provided for demonstration and educational purposes only.” ↑b
  13. 13Claude Code Docs, Plugin security and trust, read at source 13 Oct 2026“A Claude Code plugin you install can execute arbitrary code on your machine with your user privileges.” and “A marketplace’s name tells you who publishes the catalog, not what each plugin in it does” ↑
  14. 14OpenAI, Codex changelog, entry “Agent skills in Codex”, 2025-12-19, read at source 13 Oct 2026“Codex now supports agent skills: reusable bundles of instructions (plus optional scripts and resources) that help Codex reliably complete specific tasks.” ↑
  15. 15OpenAI, Build skills, read at source 13 Oct 2026user location “$HOME/.agents/skills”; “For repositories, Codex scans .agents/skills in every directory from your current working directory up to the repository root.”; “To add curated skills beyond the built-ins for your own local Codex setup, use $skill-installer.” ↑a“Use [[skills.config]] entries in ~/.codex/config.toml to disable a skill without deleting it” ↑b“Skills build on the open agent skills standard.” ↑c
  16. 16GitHub, GitHub Copilot now supports Agent Skills, 18 Dec 2025, read at source 13 Oct 2026“You can now create Agent Skills to teach Copilot how to perform specialized tasks in a specific, repeatable way.” ↑
  17. 17GitHub Docs, About agent skills, read at source 13 Oct 2026“Project skills, stored in your repository (.github/skills, .claude/skills, or .agents/skills)”; “Personal skills, stored in your home directory and shared across projects (~/.copilot/skills or ~/.agents/skills)”; “You can also use gh skill in GitHub CLI to discover and install skills from GitHub repositories.” ↑
  18. 18Gemini CLI, Changelogs, read at source 13 Oct 2026v0.24.0, 2026-01-14, “We’ve introduced significant advancements in Agent Skills”; v0.25.0, 2026-01-20, “enabled skills by default”; v0.26.0, 2026-01-27, “enabled agent skills by default”. ↑
  19. 19Gemini CLI, Agent Skills, read at source 13 Oct 2026“User skills: Located in ~/.gemini/skills/ or the ~/.agents/skills/ alias.”; “Workspace skills: Located in .gemini/skills/ or the .agents/skills/ alias.”; “You will see a confirmation prompt in the UI detailing the skill’s name, purpose, and the directory path it will gain access to.” ↑a“The .agents/skills/ alias provides an interoperable path for managing agent-specific expertise that remains compatible across different AI tools.” ↑b“/skills disable <name>: Prevents a specific skill from being used.” and the example “gemini skills uninstall my-skill --scope workspace” ↑c
  20. 20Cursor, Changelog 2.4, Jan 22, 2026, read at source 13 Oct 2026“Cursor now supports Agent Skills in the editor and CLI.” ↑
  21. 21Cursor, Agent Skills (Cursor docs), read at source 13 Oct 2026lists .agents/skills/, .cursor/skills/, ~/.agents/skills/ and ~/.cursor/skills/; “For compatibility, Cursor also loads skills from Claude and Codex directories: .claude/skills/, .codex/skills/, ~/.claude/skills/, and ~/.codex/skills/.” ↑
  22. 22Gemini CLI, Agent Skills, read at source 13 Oct 2026, on --consent“Acknowledge security risks and skip the interactive confirmation during installation.” ↑
  23. 23Claude Code Docs, Extend Claude with skills, read at source 13 Oct 2026, “Remove a skill”“Personal or project skill: delete the skill’s directory”; “Plugin skill: disable or uninstall the plugin that provides it, from the /plugin menu or with /plugin uninstall <plugin-name>@<marketplace-name>.”; “If you delete the directory by hand instead, the next sync downloads it again while the skill stays enabled on claude.ai.” ↑
  24. 24Claude Help Center, Use skills in Claude, read at source 13 Oct 2026, troubleshooting“Verify the skill is toggled on in Customize > Skills.” and “Try being more explicit in your request” ↑

Read at source 13 Oct 2026: Claude Help Center, Use skills in Claude, How to create custom skills and Use plugins in Claude; Anthropic, Agent Skills (developer docs); Claude Code Docs, Extend Claude with skills, Install and manage plugins and Plugin security and trust; the vendor docs and changelogs for Codex, GitHub Copilot, Gemini CLI and Cursor linked above.

The recipe-card comparison, the order of the five checks, and the advice marked as this site’s (follow the help centre where it differs from the docs, keep descriptions under 200 characters, leave --consent off, switch telemetry off) are this site’s own, not claims from these sources. Menus and folder names change; each vendor’s page is the current version.

Free printable AI cheat sheets, and AI news every week.

Sixteen one-page AI guides and checklists in one free PDF, no sign-up. And if you want to keep up, the newsletter covers what changed in AI each week, in plain English, with the sources.

SUBSCRIBE FREE ↗ GET THE CHEAT SHEET PACK
aipromptgeneer://$ about this siteAI PROMPT GENEERAI explained in plain English. Every claim links to its source, with the date it was checked.NEWSLETTERWhat changed in AI each week, in plain English.SUBSCRIBE FREE ↗AI PROMPT GENEER · MACHINE ASSISTANCE DISCLOSEDEVERY ARTICLE CARRIES ITS OWN CHECKED DATE