skill CX Codex

shared — Claude Code skill: templates and rules for building skills

Q: How do I install shared in Claude?

Run `npx skills add rshankras/claude-code-apple-skills --skill shared -a claude-code`. The skill file then sits at `~/.claude/skills/shared/SKILL.md`.

Helps you write new skills and clean up existing ones: structure, front matter, splitting into modules. Useful once your agent starts losing track of your instructions.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add rshankras/claude-code-apple-skills --skill shared -a claude-code

Open on GitHub

What shared does

The skill activates when you ask to create a skill, ask about skill structure, or want to refactor an old one. It ships one module, skill-creator/: templates for simple and modular skills, a walkthrough of YAML front matter, modularization patterns, and a list of common pitfalls. The flow is short — figure out what you need, read the module files, apply them to your case.

Tools are plain: Read, Write, Glob, Grep, Bash. Nothing extra to install, and no magic either — this is a set of text templates and advice, not a code generator. If you already have your own skill format, expect to adapt the templates by hand.

Worth it when you maintain several skills and want them consistent. For a single small skill you won't notice the difference.

What it helps with

create a new skill from a template
split an oversized skill into modules
get YAML front matter right
rewrite an old skill to match current structure
figure out why the agent ignores your instructions

Example prompts for the agent

help me create a new skill for handling migrations
split my skill into modules, it has grown too big
check the front matter in ~/.claude/skills/shared/SKILL.md

How to install shared

1Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill shared -a claude-code

2Manually: put the files in place

~/.claude/skills/shared/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/shared/

1Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill shared -a codex

2Manually: put the files in place

.agents/skills/shared/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill shared -a cursor

2Manually: put the files in place

.cursor/skills/shared/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install rshankras/claude-code-apple-skills shared

2Manually: put the files in place

.github/skills/shared/SKILL.md

1Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill shared -a gemini-cli

2Platform CLI

gemini skills install https://github.com/rshankras/claude-code-apple-skills --path skills/shared

Manually: put the files in place

.devin/skills/shared/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add rshankras/claude-code-apple-skills --skill shared -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about shared

How do I install shared in Claude?

Run npx skills add rshankras/claude-code-apple-skills --skill shared -a claude-code. The skill file then sits at ~/.claude/skills/shared/SKILL.md.

What does the shared skill do?

It provides templates and guidance for creating and improving skills: structure, front matter, modularization. The skill-creator/ module holds the examples and common pitfalls.

Which platforms does shared support?

It is described as platform-agnostic: Claude, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode. Each platform has its own install command.

Source text

SKILL.md · MIT

---
name: shared
description: Platform-agnostic skills including skill creation templates and best practices. Use when creating new skills or improving existing ones.
allowed-tools: [Read, Write, Glob, Grep, Bash]
last_verified: 2026-07-16
review_by: 2027-06-22
---

# Shared Skills

Platform-agnostic skills that work across iOS, macOS, and other Apple platforms. This category provides foundational tools for extending Claude Code's capabilities.

## When This Skill Activates

Use this skill when the user:
- Wants to create a new Claude Code skill
- Asks about skill structure or organization
- Wants to improve or refactor existing skills
- Needs help with skill modularization
- Asks about skill best practices or templates

## Available Modules

Read relevant module files based on the user's needs:

### skill-creator/
Templates and guidance for creating well-structured Claude Code skills.
- Skill structure and organization patterns
- YAML front matter configuration
- Modularization strategies
- Templates for simple and complex skills
- Best practices and common pitfalls

## How to Use

1. Identify user's need from their question
2. Read relevant module files from subdirectories
3. Apply the guidance to their specific context
4. Provide examples from existing skills when helpful

## Example Workflow

**User wants to create a new skill:**
1. Read `skill-creator/SKILL.md` for the full creation process
2. Determine skill complexity (simple vs modularized)
3. Guide through front matter, structure, and content
4. Reference existing skills as examples

rspress-description-generator rstackjs A skill that fills in the description frontmatter field on Rspress pages that lack one. Useful when the docs site has grown and meta descriptions are missing in places. CX Codex +1 498installs shared-dao haowjy Keeps story terms consistent across lore files and drafts, organizing them inside kb/. It eliminates drifting names, ambiguous factions, and conflicting magic systems. CX Codex +1 520installs nature-shared Yuan1z0825 A support package for the Nature Skills set. It holds shared definitions and journal formats that other skills load on demand, and never runs on its own. CX Codex +1 13,200installs validate-plugin ruvnet Checks a Claude Code plugin’s structure, frontmatter, and MCP tool references before publishing or after changes. CX Codex +1 741installs agent-identifier Galaxy-Dawn This skill helps create and configure Claude Code agents, from frontmatter to system prompts. Use it for autonomous multi-step work. CX Codex +1 344installs spark-recipe-shared-inbox-status readdle Reports how many emails in shared inboxes are still open, which ones have no owner, and how assignments sit across the team. CX Codex +1 336installs

From the same set17

generators Generates production-ready Swift code for iOS and macOS components, including StoreKit 2 paywalls, onboarding, logging, and SwiftData. CX Codex +1 494installs security A security category index for Apple platforms that routes prompts directly to the privacy-manifests skill. CX Codex +1 489installs swift-development Reviews Swift concurrency, memory and code size: helps you migrate to Swift 6 strict mode and cut heap allocations. CX Codex +1 488installs legal Writes privacy policies, terms of service and EULAs around how your app actually handles data and which markets you ship to. CX Codex +1 484installs testing A set of TDD workflows and test infrastructure for Apple platform apps. Useful when an agent writes the code and you want tests around it. CX Codex +1 468installs monetization Monetization strategy assistant for iOS and macOS apps that guides pricing model choices, readiness audits, and tier structuring. CX Codex +1 453installs growth A skill for indie Apple developers: metrics, press outreach, community and business ops. Useful once the app ships and growth stalls. CX Codex +1 423installs core-ml Guides Core ML, Vision, NaturalLanguage and Create ML work in iOS and macOS projects, from model integration to training a custom classifier. CX Codex +1 414installs