ai-agent-skills 2.0.1 → 3.0.0

package/.skills/ai-skills-4avRYs/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-wkFjII.git",
+  "skill": "ai-skills-4avRYs",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:36:05.068Z",
+  "updatedAt": "2026-03-18T13:36:05.068Z"
+}

package/.skills/ai-skills-4avRYs/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-8rNBNT/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-nfOft0.git",
+  "skill": "ai-skills-8rNBNT",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:35:14.163Z",
+  "updatedAt": "2026-03-18T13:35:14.163Z"
+}

package/.skills/ai-skills-8rNBNT/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-9FpYNq/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-6hgvB0.git",
+  "skill": "ai-skills-9FpYNq",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:35:39.658Z",
+  "updatedAt": "2026-03-18T13:35:39.658Z"
+}

package/.skills/ai-skills-9FpYNq/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-C1Emv9/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-OyeNjW.git",
+  "skill": "ai-skills-C1Emv9",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:36:11.118Z",
+  "updatedAt": "2026-03-18T13:36:11.118Z"
+}

package/.skills/ai-skills-C1Emv9/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-DRjQpJ/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-Z8LeIA.git",
+  "skill": "ai-skills-DRjQpJ",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:37:10.800Z",
+  "updatedAt": "2026-03-18T13:37:10.800Z"
+}

package/.skills/ai-skills-DRjQpJ/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-OIZADr/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-WwMG5s.git",
+  "skill": "ai-skills-OIZADr",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:35:33.815Z",
+  "updatedAt": "2026-03-18T13:35:33.815Z"
+}

package/.skills/ai-skills-OIZADr/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-PaEPLI/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-LxGimU.git",
+  "skill": "ai-skills-PaEPLI",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:35:10.097Z",
+  "updatedAt": "2026-03-18T13:35:10.097Z"
+}

package/.skills/ai-skills-PaEPLI/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-QEIEpN/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-BRwGJS.git",
+  "skill": "ai-skills-QEIEpN",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:35:05.649Z",
+  "updatedAt": "2026-03-18T13:35:05.649Z"
+}

package/.skills/ai-skills-QEIEpN/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-WLdMPM/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-260blK.git",
+  "skill": "ai-skills-WLdMPM",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:37:18.360Z",
+  "updatedAt": "2026-03-18T13:37:18.360Z"
+}

package/.skills/ai-skills-WLdMPM/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-bNmvTq/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-J2gkiN.git",
+  "skill": "ai-skills-bNmvTq",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:37:03.078Z",
+  "updatedAt": "2026-03-18T13:37:03.078Z"
+}

package/.skills/ai-skills-bNmvTq/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-gmrY1L/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-nyV8dM.git",
+  "skill": "ai-skills-gmrY1L",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:36:18.386Z",
+  "updatedAt": "2026-03-18T13:36:18.386Z"
+}

package/.skills/ai-skills-gmrY1L/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-hs6BfU/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-Hgagxw.git",
+  "skill": "ai-skills-hs6BfU",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:36:42.577Z",
+  "updatedAt": "2026-03-18T13:36:42.577Z"
+}

package/.skills/ai-skills-hs6BfU/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/.skills/ai-skills-xZKz7I/.skill-meta.json

@@ -0,0 +1,8 @@
+{
+  "source": "git",
+  "url": "file:///var/folders/sx/j7zc7dw930b9j7dpfkcgvvy40000gn/T/skill-bare-i0IBZP.git",
+  "skill": "ai-skills-xZKz7I",
+  "scope": "legacy",
+  "installedAt": "2026-03-18T13:35:21.992Z",
+  "updatedAt": "2026-03-18T13:35:21.992Z"
+}

package/.skills/ai-skills-xZKz7I/SKILL.md

@@ -0,0 +1 @@
+# Test Skill

package/README.md

@@ -6,18 +6,19 @@
 
 <p align="center">
   <strong>There are a lot of agent skills now. These are the ones I keep around.</strong><br>
-  Some are mine. Some come from other great repos.
+  Some are mine. Some come from other great repos.<br>
+  <em>My curated agent skills library</em>
 </p>
 
 <p align="center">
   <img src="https://img.shields.io/badge/skills-48-blue?style=flat-square" alt="Skills" />
-  <img src="https://img.shields.io/badge/agents-11+-green?style=flat-square" alt="Compatible Agents" />
   <img src="https://img.shields.io/npm/v/ai-agent-skills?style=flat-square&color=red" alt="npm" />
   <img src="https://img.shields.io/npm/dt/ai-agent-skills?style=flat-square&color=orange" alt="Downloads" />
 </p>
 
 <p align="center">
   <a href="#quick-start"><strong>Quick Start</strong></a> ·
+  <a href="#install-from-any-source"><strong>Install from Any Source</strong></a> ·
   <a href="#read-the-library"><strong>Read the Library</strong></a> ·
   <a href="#work-areas"><strong>Work Areas</strong></a> ·
   <a href="#cli-collections"><strong>CLI Collections</strong></a> ·
@@ -35,7 +36,7 @@ I launched this on December 17, 2025, the day after Agent Skills became an open
 
 This repo is my library of agent skills: the ones I use, adapt, or recommend.
 
-I built it first as a universal installer. That still works, but the center now is curation: work-area organization, source lineage, trust metadata, and stable vendored installs.
+I built it first as a universal installer. That still works, but the center now is curation: work-area organization, source lineage, trust metadata, and stable vendored installs. v3 simplifies the install model to two scopes: global (`~/.claude/skills/`) for your personal library, and project (`.agents/skills/`) for skills committed with your repo.
 
 If you only want the default universal installer flow, use `skills.sh`. If you want a curated library with explicit provenance, use this repo.
 
@@ -49,26 +50,53 @@ If you only want the default universal installer flow, use `skills.sh`. If you w
 ## Quick Start
 
 ```bash
-# Install one skill to all supported agents
+# Browse the library
+npx ai-agent-skills
+
+# Install a skill
 npx ai-agent-skills install frontend-design
 
-# Install to a specific agent only
-npx ai-agent-skills install frontend-design --agent cursor
+# Install from any GitHub repo
+npx ai-agent-skills install anthropics/skills
 
-# Browse curated collections
-npx ai-agent-skills collections
+# Install to your project (shared with team)
+npx ai-agent-skills install pdf -p
+```
 
-# Browse by work area
-npx ai-agent-skills list --work-area frontend
+Skills install to `~/.claude/skills/` by default.
+Use `-p` for project-scoped installs to `.agents/skills/`, where most major agents can read them.
 
-# Search the catalog
-npx ai-agent-skills search testing
+## How the Catalog Works
 
-# Browse the library in the terminal
-npx ai-agent-skills browse
+Every skill in this library carries metadata beyond a name and description. Here is what a real entry looks like:
+
+```json
+{
+  "name": "ask-questions-if-underspecified",
+  "author": "thsottiaux",
+  "origin": "adapted",
+  "trust": "verified",
+  "syncMode": "adapted",
+  "sourceUrl": "https://github.com/MoizIbnYousaf/Ai-Agent-Skills/...",
+  "whyHere": "Kept because this requirement-clarification pattern is one of the cleanest ways to stop agents from running ahead on underspecified work.",
+  "lastVerified": "2026-03-13"
+}
+```
+
+`trust` tells you how much review a skill has received: verified, reviewed, or listed. `syncMode` tells you whether the skill tracks upstream changes or is pinned as a stable snapshot. `whyHere` is a written rationale for why this specific skill belongs in the library. You can see this for any skill by running `npx ai-agent-skills info <name>`.
+
+## Install from Any Source
+
+Point the CLI at any GitHub repo that follows the SKILL.md standard:
+
+```bash
+npx ai-agent-skills install anthropics/skills
+npx ai-agent-skills install anthropics/skills@frontend-design
+npx ai-agent-skills install anthropics/skills --list
+npx ai-agent-skills install ./local-skills
 ```
 
-By default, `install` targets the major agents I already support: Claude Code, Cursor, Codex, Amp, VS Code, Copilot, Gemini CLI, Goose, Letta, Kilo Code, and OpenCode.
+Use `--skill` to pick specific skills. Use `--list` to see what's available before installing.
 
 ## Read the Library
 
@@ -105,7 +133,6 @@ If you want the same map in the terminal, use `npx ai-agent-skills browse`.
 |-----------|----------------|------------------|--------------|
 | Frontend | Product UI, interface systems, and design implementation work | React, Figma, UI | Anthropic, OpenAI, Composio |
 | Backend | APIs, architecture, databases, MCP, and deeper codebase work | MCP, Database, Python | wshobson, Anthropic |
-| Mobile | Handheld product work and release support | Expo, Swift | Selective coverage |
 | Docs | Documents, specs, code docs, and product documentation | PDF, Writing, OpenAI | Anthropic, OpenAI |
 | Testing | Review, QA, browser automation, CI, and observability | Regression, CI, Browser Automation, Observability | Moiz, Anthropic, OpenAI |
 | Workflow | Clarification, plans, files, and execution support | Clarification, Planning, Jira, Files | Moiz, OpenAI, Composio |
@@ -148,22 +175,6 @@ Some skills track clean upstream mirrors. Others are stable snapshots I keep ven
 | [ComposioHQ/awesome-claude-skills](https://github.com/ComposioHQ/awesome-claude-skills) | Broad practical coverage for workflow, files, research, and creative tasks. | 15 skills |
 | [MoizIbnYousaf/Ai-Agent-Skills](https://github.com/MoizIbnYousaf/Ai-Agent-Skills) | The skills I write and maintain directly. | 5 skills |
 
-## Supported Agents
-
-| Agent | Flag | Install Location |
-|-------|------|------------------|
-| Claude Code | `--agent claude` | `~/.claude/skills/` |
-| Cursor | `--agent cursor` | `.cursor/skills/` |
-| Codex | `--agent codex` | `~/.codex/skills/` |
-| Amp | `--agent amp` | `~/.amp/skills/` |
-| VS Code / Copilot | `--agent vscode` | `.github/skills/` |
-| Gemini CLI | `--agent gemini` | `~/.gemini/skills/` |
-| Goose | `--agent goose` | `~/.config/goose/skills/` |
-| OpenCode | `--agent opencode` | `~/.config/opencode/skill/` |
-| Letta | `--agent letta` | `~/.letta/skills/` |
-| Kilo Code | `--agent kilocode` | `~/.kilocode/skills/` |
-| Portable | `--agent project` | `.skills/` |
-
 ## Commands
 
 ```bash
@@ -172,28 +183,66 @@ npx ai-agent-skills browse
 npx ai-agent-skills collections
 npx ai-agent-skills list
 npx ai-agent-skills list --work-area frontend
-npx ai-agent-skills list --category development
 npx ai-agent-skills list --collection my-picks
 npx ai-agent-skills search testing
 npx ai-agent-skills info frontend-design
 
 # Installation
 npx ai-agent-skills install <name>
-npx ai-agent-skills install <name> --agent cursor
+npx ai-agent-skills install <name> -p
 npx ai-agent-skills install <owner/repo>
-npx ai-agent-skills install <git-url>
+npx ai-agent-skills install <owner/repo>@<skill>
+npx ai-agent-skills install <owner/repo> --list
+npx ai-agent-skills install <owner/repo> --skill <name>
 npx ai-agent-skills install ./path
 npx ai-agent-skills install <name> --dry-run
 
 # Management
 npx ai-agent-skills uninstall <name>
-npx ai-agent-skills update <name>
-npx ai-agent-skills update --all
+npx ai-agent-skills update [name]
+npx ai-agent-skills check
+
+# Authoring
+npx ai-agent-skills init [name]
 
 # Configuration
-npx ai-agent-skills config --default-agent cursor
+npx ai-agent-skills config
+```
+
+<details>
+<summary>Legacy agent support</summary>
+
+These agents are still supported via `--agent <name>`:
+
+| Agent | Flag | Install Location |
+|-------|------|------------------|
+| Claude Code | `--agent claude` | `~/.claude/skills/` |
+| Cursor | `--agent cursor` | `.cursor/skills/` |
+| Codex | `--agent codex` | `~/.codex/skills/` |
+| Amp | `--agent amp` | `~/.amp/skills/` |
+| VS Code / Copilot | `--agent vscode` | `.github/skills/` |
+| Gemini CLI | `--agent gemini` | `~/.gemini/skills/` |
+| Goose | `--agent goose` | `~/.config/goose/skills/` |
+| OpenCode | `--agent opencode` | `~/.config/opencode/skill/` |
+| Letta | `--agent letta` | `~/.letta/skills/` |
+| Kilo Code | `--agent kilocode` | `~/.kilocode/skills/` |
+| Portable | `--agent project` | `.skills/` |
+
+</details>
+
+## What Are Agent Skills?
+
+Agent skills follow the open format documented at [agentskills.io](https://agentskills.io). A skill is just a folder:
+
+```text
+my-skill/
+├── SKILL.md
+├── scripts/
+└── references/
 ```
 
+All major coding agents support some variation of this pattern.
+
 ## Manual Install
 
 ```bash
@@ -214,19 +263,6 @@ Before opening a PR:
 4. Put the skill on a top-level shelf only if it clearly belongs there.
 5. Explain why it belongs here.
 
-## What Are Agent Skills?
-
-Agent skills follow the open format documented at [agentskills.io](https://agentskills.io). A skill is just a folder:
-
-```text
-my-skill/
-├── SKILL.md
-├── scripts/
-└── references/
-```
-
-All major coding agents support some variation of this pattern.
-
 ## Links
 
 - [Agent Skills Spec](https://agentskills.io)

package/WORK_AREAS.md

@@ -34,15 +34,6 @@ Infra, tooling, application architecture, and codebase depth.
 | Refactoring | [`code-refactoring`](./skills/code-refactoring) | wshobson |
 | TypeScript | [`javascript-typescript`](./skills/javascript-typescript) | wshobson |
 
-## Mobile
-
-App work for iOS, Android, Expo, and handheld product flows.
-
-**Coverage:** intentionally selective right now.  
-**Main sources:** none active in the package today
-
-This area stays in the browse model because it matters, but I am not keeping weak mobile pointers in the library just to fill the shelf.
-
 ## Docs
 
 Documents, specs, file handling, and long-form output.