Skills

Reusable AI agent skills for iOS/macOS development.

What is a skill?

A skill is a self-contained knowledge package that teaches an AI agent how to perform a specific task correctly. Each skill includes a workflow, code patterns, and reference material.

Structure

Each skill lives in its own directory:

<skill-name>/
  SKILL.md                  # Main skill definition
  agents/
    openai.yaml             # Agent registration config
  references/               # Optional reference docs
    *.md

Skills

Skill	Description
changelog	Maintain CHANGELOG.md following Keep a Changelog
ios-xcui-screenshot-tests	Write correct XCUIAutomation screenshot tests
semver	Manage version numbers with Semantic Versioning 2.0.0

Usage

Skills can be installed globally or per-project:

• Global: ~/.claude/skills/
• Project: .claude/skills/

Adding a new skill

1. Create a directory with the skill slug (lowercase kebab-case)
2. Add SKILL.md with YAML frontmatter (name, description, metadata)
3. Add agents/openai.yaml with interface and policy config
4. Optionally add references/ for supplementary docs
5. Sanitize all content — remove project names, personal URLs, credentials, and any identifying information before committing
6. Update this README and the CHANGELOG