All posts
AI toolsSkillsAI agents

How to Install Agent Skills in Claude, ChatGPT, Cursor, Kimi & GLM

Install Agent Skills (SKILL.md) in Claude Code, ChatGPT / Codex, Cursor, Gemini, Kimi, and GLM — paths, triggers, and a design-skill workflow that sticks.

AD
Agent's Design

Installing Agent Skills means placing a folder with SKILL.md where your agent discovers skills — then verifying Claude, ChatGPT, Cursor, Codex, Gemini, Kimi, or GLM can trigger it from the description. For design work, install one taste skill, add a DESIGN.md from the gallery, and run the same UI prompt with the skill on. Paths differ by tool; the file format does not.

Before you install

You need:

  1. A skill folder containing SKILL.md (YAML frontmatter + Markdown body)
  2. An agent that supports the Agent Skills standard (Claude Code, Cursor, Codex / ChatGPT coding, Gemini CLI, and many others — including stacks that run Kimi or GLM)
  3. Optional: a design template so the skill has tokens to obey

If you are new to the format, read What are Agent Skills? first.

Install paths by agent

AgentProject (repo) skillsUser (global) skills
Claude Code.claude/skills/<name>/SKILL.md~/.claude/skills/<name>/SKILL.md
Cursor.cursor/skills/<name>/SKILL.mdAlso discovers .claude/skills/ and Codex-compatible dirs
ChatGPT / Codex.agents/skills/ or .codex/skills/~/.agents/skills/ (and related Codex user paths)
Gemini CLI.gemini/skills/~/.gemini/skills/
Kimi / GLM CLIsVendor skills directory or shared Agent Skills pathCheck the product docs for the exact folder

Team tip: Commit project skills to git so Claude, Cursor, and ChatGPT sessions on the same repo share craft rules. Keep personal experiments in the user-level folder.

Method A — Copy a skill into the repo (most reliable)

  1. Create the folder: .cursor/skills/tasteful-ui/ (or .claude/skills/…)
  2. Add SKILL.md with name + description + steps
  3. Restart the agent session or reload the window so discovery refreshes
  4. Ask: "What skills do you have?" or invoke /tasteful-ui if your client supports slash skills
  5. Run a design task and confirm the skill body influenced the plan

Example frontmatter:

---
name: tasteful-ui
description: Use when building or redesigning UI, landing pages, or marketing sections. Applies anti-slop layout and type rules.
---

Method B — Install from a registry or CLI

Many ecosystems expose npx skills add … or vendor-specific installers. Flow:

  1. Find the skill on a registry or on /skills
  2. Run the documented install command for your agent
  3. Confirm files landed under a discovered skills path
  4. Open Claude Code, Cursor, or ChatGPT/Codex and trigger a matching task

Prefer design skills with demos. A popular download with no craft rules still ships slop on Claude and on Kimi.

Method C — One skill, multiple agents (monorepo pattern)

If your team mixes tools:

repo/
  .agents/skills/tasteful-ui/SKILL.md   # Codex / ChatGPT-friendly
  .claude/skills/tasteful-ui -> ../../.agents/skills/tasteful-ui
  .cursor/skills/tasteful-ui -> ../../.agents/skills/tasteful-ui
  DESIGN.md

Symlinks keep a single source of truth. Cursor often already reads Claude/Codex skill directories — check your Cursor version docs before duplicating.

Verify the skill actually loads

Claude

  • Start Claude Code in the repo
  • Ask it to list available skills or to use /skill-name
  • Give a UI task that matches the description
  • Confirm the response references skill steps (anti-patterns, DESIGN.md, section scope)

ChatGPT / Codex

  • Open a coding session with repo access
  • Mention the skill or rely on auto-trigger from the description
  • Watch for plan steps that mirror the skill body
  • If nothing fires, invoke explicitly with the client's skill mention syntax

Cursor

  • Agent mode / Composer with the project open
  • Use /skill-name when auto-invocation is off
  • @-reference DESIGN.md alongside the skill for UI tasks
  • Keep diffs scoped — skills help most when you do not ask for the whole app at once

Kimi, GLM, Gemini

  • Confirm the CLI or IDE plugin supports Agent Skills paths
  • Install to the documented folder
  • Run the same landing-page prompt you use with Claude or ChatGPT
  • Compare: skill off vs skill on — the delta should be obvious

Model quality still matters. A strong Claude or ChatGPT model follows nuanced craft better than a weak local run — but without a skill, every model regresses to generic UI.

Design-skill install checklist

Use this when the goal is tasteful UI, not generic coding helpers:

  • Skill description mentions UI / landing / redesign triggers
  • Body bans specific slop patterns
  • Body tells the agent to read DESIGN.md when present
  • Repo has a DESIGN.md from Agent's Design or your brand
  • Only one primary taste skill enabled
  • Tested on your daily driver (Claude or Cursor or ChatGPT) and spot-checked on a second model (Kimi, GLM, or Gemini)

Troubleshooting

ProblemFix
Skill never triggersSharpen description; invoke manually; restart session
Skill triggers on everythingNarrow description; set manual-only if supported
Output still looks templatedAdd DESIGN.md + gallery template; see stop AI UI looking templated
Works in Claude, missing in CursorCopy or symlink into a path Cursor discovers
Works in ChatGPT, fails in Kimi/GLMConfirm that client’s skills directory and reload
Overlapping skills fightDisable extras; keep one craft skill

Minimal DESIGN.md hook (paste into skill body)

## Design constraints

1. If DESIGN.md exists, read it before writing UI. Do not invent tokens.
2. Build one section per request.
3. No purple gradients, no Inter unless specified, no three identical feature cards.
4. Prefer existing components in components/ui when present.

That block alone improves Claude, ChatGPT, Cursor, Kimi, and GLM sessions.

After install — first session script

  1. Browse a skill demo on /skills
  2. Install the skill via Method A or B
  3. Copy a template DESIGN.md from the gallery
  4. Prompt: "Using the tasteful-ui skill and DESIGN.md, implement the hero only"
  5. Review in the browser; then next section
  6. Repeat in a second agent (e.g. Claude plan → Cursor apply, or ChatGPT → local GLM check)

Related guides

Skills are files. Install them where your agent looks, keep DESIGN.md beside them, and your Claude, ChatGPT, Kimi, and GLM sessions stop negotiating taste from scratch every time.

Ship the next screen with taste

Browse agent-ready templates, DESIGN.md specs, and prompts in the gallery — then paste into Cursor, Claude Code, or v0.

Keep reading