# Curate A Team Library

Use when building a managed team skills library for a real stack.

- Repository: https://github.com/MoizIbnYousaf/ai-agent-skills (1155 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-09-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add MoizIbnYousaf/ai-agent-skills --skill curate-a-team-library -g -a claude-code -y`
Codex: `npx skills add MoizIbnYousaf/ai-agent-skills --skill curate-a-team-library -g -a codex -y`
Cursor: `npx skills add MoizIbnYousaf/ai-agent-skills --skill curate-a-team-library -g -a cursor -y`
Gemini CLI: `npx skills add MoizIbnYousaf/ai-agent-skills --skill curate-a-team-library -g -a gemini-cli -y`

## Description

Use when building a managed team skills library for a real stack. Map work to shelves, browse before curating, write meaningful `whyHere` notes, and create a starter pack once the first pass is solid.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Curate A Team Library

## Goal

Build a managed skills library that another teammate or agent can actually browse, trust, and install.

Do not hand-edit `skills.json`, `README.md`, or `WORK_AREAS.md` when the CLI already has the mutation you need.

## First Move

Start with a managed workspace.

```bash
npx ai-agent-skills init-library <name>
cd <name>
```

Ask at most 3 short questions before acting:

- what kinds of work the library needs to support
- whether the first pass should stay small and opinionated or aim broader
- whether the output should stay local or end as a shareable GitHub repo

## Shelf System

Use these 5 work areas as the shelf system:

- `frontend`: web UI, browser work, design systems, visual polish
- `backend`: APIs, data, security, infrastructure, runtime systems
- `mobile`: iOS, Android, React Native, Expo, device testing, app delivery
- `workflow`: docs, testing, release work, files, research, planning
- `agent-engineering`: prompts, evals, tools, orchestration, agent runtime design

Map the user's stack to shelves before adding anything.

- Example: `React Native + Node backend` maps to `mobile` + `backend`.
- Add `workflow` only when testing, release, docs, or research are real parts of the job.
- Add `agent-engineering` only when the team is doing AI features, prompts, evals, or tooling.
- Make sure the first pass covers every primary shelf the user explicitly named.

## Discovery Loop

Browse before curating.

```bash
npx ai-agent-skills list --area <work-area>
npx ai-agent-skills search <query>
npx ai-agent-skills collections
```

If the user named multiple primary shelves, inspect each one before choosing skills.

## Mutation Rules

Keep the first pass small: around 3 to 8 skills.

- Use `add` first for bundled picks and simple GitHub imports.
- Use `catalog` when you want an upstream entry without copying files into `skills/`.
- Use `vendor` only for true house copies the team wants to edit or own locally.

The rest: https://github.com/MoizIbnYousaf/ai-agent-skills/blob/HEAD/skills/curate-a-team-library/SKILL.md