ai-docs/docs/ai/skills.md

Skills Library

You are here: AI Docs Home > Skills Library

Contents

• Skills vs Agents vs Instructions
• Skills Governance And Sync
• Skills CLI (Single Path)
• How To Connect Skills
• Central Assets Repo
• Next Steps

Skills vs Agents vs Instructions

• Skills are reusable workflows you load for specific tasks.
• Agents are full modes/personas that control behavior end-to-end.
• Instructions are always-on repo rules that auto-apply by file pattern.

What Skills Are

Skills are reusable instructions and workflows that guide the assistant through specialized tasks.

When To Use A Skill

• The task has a repeatable workflow.
• You want consistent structure and outputs.
• The task spans multiple files or steps.

Skills Directory

Store skills in the team-approved skills directory for your environment. If you do not know the location, ask your team lead or check your internal setup docs.

Example Question To Ask

Example prompt:

Where is the approved skills directory for our team, and how do I add a new skill?

Skills Governance And Sync

To keep skills consistent across teams, use a central skills registry plus a per-project manifest. Avoid copying skills into every repo unless the skill is tightly coupled to the project.

Recommended Pattern

• Central skills registry repo (single source of truth)
• Project-level manifest that pins required skills and versions
• Sync script that installs the approved set to each developer's laptop
• Agents.md points to the manifest and sync command

Curated Assets Structure (Current)

Keep the approved list in a single repo and organize by platform. This repo already includes the /assets folder as the staging area for a future migration.

/assets/
	setup.sh              ← the installer (auto-discovers agents & instructions)
	ios-skills.txt        ← curated iOS skills (one per line)
	android-skills.txt    ← curated Android skills
	shared-skills.txt     ← curated cross-platform skills
	agents/               ← agent prompt files (auto-discovered)
	instructions/         ← instruction rule files (auto-discovered)

Project Manifest Example

Skills files are plain text. Each non-empty, non-comment line is passed to npx skills add:

# iOS Skills
avdlee/swiftui-agent-skill@swiftui-expert-skill

Sync Workflow

1. Update the curated list in assets (shared, iOS, or Android).
2. Run ./assets/setup.sh skills ios (or android, shared).
3. The script installs each skill using the npx skills CLI.
4. Restart your editor if required.

Example Sync Commands

# Install iOS skills
./assets/setup.sh skills ios

# Install everything (skills + agents + instructions)
./assets/setup.sh all ios

# Remote — no clone required
export ASSETS_BASE_URL="https://gitlab.com/<org>/mobile-ai-docs/-/raw/develop/assets"
bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") all ios

Skills CLI (Single Path)

We use a single, approved path: update the curated list under assets/ and run the sync script. The sync script calls npx skills add for each entry.

Where To Find Skills

• Homepage: https://skills.sh/
• Docs: https://skills.sh/docs
• CLI reference: https://skills.sh/docs/cli

How It Works (High-Level)

1. You update assets/shared-skills.txt (or a platform list) with approved install entries — one per line.
2. Run ./assets/setup.sh skills (or skills ios, skills android).
3. The script uses npx skills add to install each entry.

Install The CLI (No Global Install Required)

The CLI runs via npx, so you do not need a global install.

Example Install Entry

Add one line to the platform file (e.g., ios-skills.txt):

avdlee/swiftui-agent-skill@swiftui-expert-skill

Notes

• The leaderboard uses anonymous telemetry from the CLI. You can opt out by setting DISABLE_TELEMETRY=1.
• Review skills before installing. The ecosystem is audited, but quality varies.

skills CLI Commands

Common commands shown in the CLI help output:

npx skills add <package>     Install a skill
npx skills list              List installed skills
npx skills find [query]      Search for skills
npx skills check             Check for updates
npx skills update            Update all skills
npx skills remove            Remove installed skills
npx skills init [name]       Create a new skill

How to Download Existing Skills

Run the setup script:

./assets/setup.sh skills ios

Or remotely without cloning:

bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") skills ios

How to Download Agents

Run the setup script:

./assets/setup.sh agents

Or remotely without cloning:

bash <(curl -fsSL "$ASSETS_BASE_URL/setup.sh") agents

Agents are installed to ~/.copilot/agents/ by default. Override with the AGENTS_DIR environment variable.

How to Enable or Configure Skills

• Follow the instructions provided in each skill's README or SKILL file.
• Some skills require additional setup, such as environment variables or tools.

How To Connect Skills

1. State the primary skill you want to use.
2. Provide the inputs that skill expects.
3. If needed, add a secondary skill and explain the handoff.

Example Skill Request

Example prompt:

Use swiftui-expert-skill to review this view for best practices. Then use webapp-testing to validate the web flow.

Central Assets Repo (Recommended)

Do not list every skill in this guide. Instead, point readers to the assets folder (or a future dedicated repo) that contains the approved agents, skills, and instructions.

Everything is installable with one command:

./assets/setup.sh all ios

• A short README with install and update steps
• Curated skill lists (for example, ios-skills.txt, android-skills.txt)

Link To The Assets Repo

• Repo: (link)

Next Steps

• For day-to-day workflows, read Cross-Platform AI Usage.
• For setup issues, follow Troubleshooting and FAQ.