ai-agent-skills 1.9.2 → 2.0.0

package/CURATION.md

@@ -0,0 +1,104 @@
+# Curation Guide
+
+This repo is my keep pile.
+
+I am not trying to mirror every agent skill on the internet. I want a strong set of skills that I would actually keep on a machine, recommend to other developers, and keep improving over time.
+Most of those skills come from other repos, so curation here is as much about provenance and trust as it is about the skill text itself.
+
+## What I Care About
+
+I want skills here to be:
+
+- genuinely useful in real work
+- clear enough that an agent can follow them well
+- reusable across more than one project
+- good enough to beat a generic prompt
+- worth maintaining
+
+If a skill does not clear that bar, I would rather leave it out.
+
+## What Usually Does Not Belong
+
+- weak rewrites of skills that already exist here
+- novelty skills that will feel dead in a month
+- skills that are so narrow they are not worth maintaining
+- skills with unclear attribution or licensing
+- prompt dumps pretending to be skills
+
+## How I Keep It Organized
+
+I keep the folder structure simple and let the catalog do the sorting.
+
+- `skills/` holds the actual skill folders
+- `skills.json` is the catalog the CLI reads
+- `workArea` and `branch` are the main browse fields in the catalog
+- `work areas` are the main browse model
+- `collections` are the shorter CLI shelves
+- `category`, `tags`, `source`, `sourceUrl`, `origin`, `syncMode`, `featured`, `verified`, and `trust` help with sorting and trust
+
+I do not want a deep folder tree. That usually makes install tooling worse and the repo harder to maintain.
+
+## Work Areas And Collections
+
+The main browse model is work area first, source repo second.
+
+Collections are still useful, but they are not meant to cover everything.
+
+- `my-picks`: the fastest way to understand my taste
+- `build-apps`: web and mobile product work with a high interface bar
+- `build-systems`: backend, architecture, MCP, and deeper engineering work
+- `test-and-debug`: review, QA, debugging, and cleanup work
+- `docs-and-research`: docs, files, research, and execution support
+
+Not every skill needs a collection. If something is useful but off to the side, search and tags can do the job.
+
+## Featured And Verified
+
+- `featured: true` means I would point people to that skill first
+- `verified: true` means I have personally checked it and I am comfortable signaling more trust
+
+I want those markers to mean something. They should stay a little hard to earn.
+
+## Trust Levels
+
+- `listed` means the skill belongs in the library, but I am not signaling much beyond that yet
+- `reviewed` means I have put a little more editorial weight behind it
+- `verified` means I have personally checked it and I am comfortable standing behind it more directly
+
+## Mirrors And Snapshots
+
+- `mirror` means the local copy still tracks a clean upstream counterpart closely
+- `snapshot` means I am intentionally shipping a stable vendored copy even if upstream has moved
+- `adapted` means the library copy is based on outside work but changed enough that I do not want to pretend it is a straight mirror
+- `authored` means I maintain the skill directly here
+
+## Agent Support
+
+I am keeping support focused on the major agents.
+
+I do not want to spend my time adding support for every new coding agent that launches, especially if I do not use it or do not think it will matter in six months.
+
+If support is here, it should be worth the maintenance burden.
+
+## Maintainer Workflow
+
+When I add or update a skill, I try to answer these questions:
+
+1. Is this actually good?
+2. Does it belong here?
+3. What is the right category?
+4. Does it deserve a top-level shelf, or should it stay tag-driven?
+5. Is it good enough to feature?
+6. Have I checked enough to verify it?
+7. Is the attribution clean?
+
+## If This Turns Into A Website
+
+The repo already has the shape for that.
+
+- home page: library first, with work areas and source repos both visible
+- browse page: collections, tags, source repos, and search
+- skill page: source, tags, collections when relevant, install command
+- trust layer: featured, verified, and catalog trust state
+
+The repo should stay where the data lives. A site can just present it better.

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 SkillCreator.ai
+Copyright (c) 2025 Moiz Ibn Yousaf
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -5,159 +5,150 @@
 </h1>
 
 <p align="center">
-  <strong>Homebrew for AI Agent Skills.</strong><br>
-  Universal Skills installer for any agent that follows the open standard spec 
+  <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.
 </p>
 
 <p align="center">
-  <img src="https://img.shields.io/badge/skills-40-blue?style=flat-square" alt="Skills" />
+  <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/badge/license-MIT-brightgreen?style=flat-square" alt="License" />
   <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="https://skillcreator.ai/explore"><strong>Browse Skills</strong></a> ·
-  <a href="https://skillcreator.ai/build"><strong>Create Skills</strong></a> ·
-  <a href="https://agentskills.io"><strong>Specification</strong></a> ·
-  <a href="https://x.com/skillcreatorai"><strong>Follow Updates</strong></a>
+  <a href="#quick-start"><strong>Quick Start</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> ·
+  <a href="#source-repos"><strong>Source Repos</strong></a> ·
+  <a href="./CURATION.md"><strong>Curation Guide</strong></a> ·
+  <a href="./CONTRIBUTING.md"><strong>Contribute</strong></a> ·
+  <a href="https://agentskills.io"><strong>Specification</strong></a>
 </p>
 
 ---
 
+## What This Is
+
+I launched this on December 17, 2025, the day after Agent Skills became an open standard, and before `skills.sh` launched on January 14, 2026.
+
+I built it as a universal installer. That still works, but it is not the center of the project. 
+
+If you just want the default universal installer now just use `skills.sh`.
+
+This repo is my library of agent skills: the ones I use, adapt, or recommend.
+
+## What I Built
+
+- An early cross-agent installer and npm CLI that still works across the major coding agents.
+- A curated cross-repo catalog that keeps sourced skills organized by work area, branch, and trust.
+- Stable vendored installs, with source attribution kept explicit instead of hidden.
+- A browsable directory and terminal atlas that turn the library into something easier to inspect than a flat repo.
+
 ## Quick Start
 
 ```bash
-# Install a skill to ALL agents with one command
+# Install one skill to all supported agents
 npx ai-agent-skills install frontend-design
 
 # Install to a specific agent only
 npx ai-agent-skills install frontend-design --agent cursor
 
-# Browse skills interactively
-npx ai-agent-skills browse
+# Browse curated collections
+npx ai-agent-skills collections
 
-# Install from any GitHub repo
-npx ai-agent-skills install anthropics/skills
-npx ai-agent-skills install anthropics/skills/pdf    # specific skill
+# Browse by work area
+npx ai-agent-skills list --work-area frontend
 
-# Install from any git URL (SSH or HTTPS)
-npx ai-agent-skills install git@github.com:anthropics/skills.git
+# Search the catalog
+npx ai-agent-skills search testing
 
-# Install from local path
-npx ai-agent-skills install ./my-custom-skill
+# Browse the library in the terminal
+npx ai-agent-skills browse
 ```
 
-**One command. Every agent.** By default, skills install to Claude Code, Cursor, Codex, Amp, VS Code, Copilot, Gemini CLI, Goose, Letta, and OpenCode simultaneously.
-
-## Why This Exists
-
-Every major AI coding agent now supports skills. But they're scattered everywhere.
-
-We also created our own repo to cureate the best in one place. Quality over quantity https://www.skillcreator.ai/explore  All skills follow the [Agent Skills spec](https://agentskills.io).
-
-## Compatible Agents
-
-Works with **Claude Code**, **Cursor**, **Codex**, **Amp**, **VS Code**, **GitHub Copilot**, **Gemini CLI**, **Goose**, **Letta**, and **OpenCode**.
-
-## Available Skills
-
-### Development
-| Skill | Description |
-|-------|-------------|
-| `frontend-design` | Production-grade UI components and styling |
-| `mcp-builder` | Create MCP servers for agent tool integrations |
-| `skill-creator` | Guide for creating new agent skills |
-| `code-review` | Automated PR review patterns |
-| `code-refactoring` | Systematic code improvement techniques |
-| `backend-development` | APIs, databases, server architecture |
-| `python-development` | Modern Python 3.12+ patterns |
-| `javascript-typescript` | ES6+, Node, React, TypeScript |
-| `webapp-testing` | Browser automation and testing with Playwright |
-| `database-design` | Schema design and optimization |
-| `llm-application-dev` | Build LLM-powered applications |
-| `artifacts-builder` | Interactive React/Tailwind web components |
-| `changelog-generator` | Generate changelogs from git commits |
-
-### Documents
-| Skill | Description |
-|-------|-------------|
-| `pdf` | Extract, create, merge, split PDFs |
-| `xlsx` | Excel creation, formulas, data analysis |
-| `docx` | Word documents with formatting |
-| `pptx` | PowerPoint presentations |
-
-### Creative
-| Skill | Description |
-|-------|-------------|
-| `canvas-design` | Visual art and poster creation |
-| `algorithmic-art` | Generative art with p5.js |
-| `image-enhancer` | Improve image quality and resolution |
-| `slack-gif-creator` | Create animated GIFs for Slack |
-| `theme-factory` | Professional font and color themes |
-| `video-downloader` | Download videos from various platforms |
-
-### Business
-| Skill | Description |
-|-------|-------------|
-| `brand-guidelines` | Apply brand colors and typography |
-| `internal-comms` | Status updates and team communication |
-| `competitive-ads-extractor` | Analyze competitor ad strategies |
-| `domain-name-brainstormer` | Generate and check domain availability |
-| `lead-research-assistant` | Identify and qualify leads |
-
-### Productivity
-| Skill | Description |
-|-------|-------------|
-| `ask-questions-if-underspecified` | Clarify requirements before implementing |
-| `doc-coauthoring` | Co-author docs, proposals, specs with structured workflow |
-| `job-application` | Cover letters and applications using your CV |
-| `qa-regression` | Automated regression testing with Playwright |
-| `jira-issues` | Create, update, search Jira issues |
-| `code-documentation` | Generate docs from code |
-| `content-research-writer` | Research and write content with citations |
-| `developer-growth-analysis` | Track developer growth metrics |
-| `file-organizer` | Organize files and find duplicates |
-| `invoice-organizer` | Organize invoices for tax prep |
-| `meeting-insights-analyzer` | Analyze meeting transcripts |
-| `raffle-winner-picker` | Randomly select contest winners |
+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.
 
-## Commands
+## Read the Library
 
-```bash
-# Interactive browser (TUI)
-npx ai-agent-skills browse
+This repo reads best in four ways:
 
-# List all available skills
-npx ai-agent-skills list
-npx ai-agent-skills list --category development
-npx ai-agent-skills list --installed --agent cursor
+| View | Best for | Start here |
+|------|----------|------------|
+| Work Areas | The main way to understand the library | `npx ai-agent-skills list --work-area frontend` |
+| CLI Collections | The fastest shortcuts when you want a short shelf | `npx ai-agent-skills list --collection my-picks` |
+| Source Repos | Seeing the upstream lineage on purpose | `npx ai-agent-skills info frontend-design` |
+| Terminal Browser | Walking the atlas instead of reading a flat repo | `npx ai-agent-skills browse` |
 
-# Install (defaults to ALL agents)
-npx ai-agent-skills install <name>                    # installs to ALL agents
-npx ai-agent-skills install <name> --agent cursor     # install to specific agent only
-npx ai-agent-skills install <owner/repo>              # from GitHub (all agents)
-npx ai-agent-skills install <git-url>                 # from any git URL (ssh/https)
-npx ai-agent-skills install ./path                    # from local path (all agents)
-npx ai-agent-skills install <name> --dry-run          # preview only
+## How I Organize It
 
-# Manage installed skills
-npx ai-agent-skills uninstall <name>
-npx ai-agent-skills update <name>
-npx ai-agent-skills update --all
+- `Work areas` are the main way to understand the library.
+- `Collections` still exist as the fastest CLI shortcuts.
+- A few skills are authored here. Most are curated from upstream repos and kept clearly attributed.
+- `Source` stays attached to every skill. The library matters, but so does provenance.
+- Imported skills are either kept as direct mirrors or stable snapshots. The installer still ships vendored copies either way.
+- `Featured` means I would actively point someone to that skill first.
+- `Verified` means I have personally checked the skill and its metadata.
+- `Categories`, `tags`, and search cover everything that does not need a top-level shelf.
 
-# Discovery
-npx ai-agent-skills search <query>
-npx ai-agent-skills info <name>
+The folder layout stays flat under `skills/<name>/` because installs stay simpler that way. The catalog handles the grouping.
+The full repo map lives in [WORK_AREAS.md](./WORK_AREAS.md).
 
-# Configuration
-npx ai-agent-skills config --default-agent cursor
+## Work Areas
+
+This is the cleanest way to read the library.
+The full repo index is in [WORK_AREAS.md](./WORK_AREAS.md).
+If you want the same map in the terminal, use `npx ai-agent-skills browse`.
+
+| Work area | What it covers | Typical branches | Main sources |
+|-----------|----------------|------------------|--------------|
+| 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 |
+| Research | Research, lead work, and synthesis that helps execution | Writing, Lead Research | Composio |
+| Design | Interface direction, themes, media, and visual craft | Interface, Figma, Themes | Anthropic, OpenAI, Composio |
+| Business | Brand, communication, naming, and adjacent operating work | Brand, Communication, Career | Anthropic, Moiz, Composio |
+
+## CLI Collections
+
+These are still useful when you want a short shelf in the CLI instead of the full work-area view.
+
+| Collection | What it's for | Start with | Main sources |
+|-------|-------------|-------------|--------------|
+| `my-picks` | The first skills I would install on a fresh setup | `frontend-design`, `mcp-builder`, `qa-regression` | Anthropic, Moiz |
+| `build-apps` | Web product work with a high interface bar | `frontend-design`, `figma-implement-design`, `theme-factory` | Anthropic, OpenAI, Composio |
+| `build-systems` | Backend, architecture, MCP, and deeper engineering work | `mcp-builder`, `backend-development`, `database-design` | wshobson, Anthropic |
+| `test-and-debug` | Review, QA, debugging, and cleanup work | `gh-fix-ci`, `playwright`, `qa-regression` | Moiz, Anthropic, OpenAI |
+| `docs-and-research` | Docs, files, research, and execution support | `openai-docs`, `pdf`, `notion-spec-to-implementation` | Anthropic, OpenAI, Composio |
+
+CLI shortcuts:
+
+```bash
+npx ai-agent-skills collections
+npx ai-agent-skills list --collection my-picks
+npx ai-agent-skills list --collection build-apps
+npx ai-agent-skills search expo
 ```
 
-### Supported Agents
+## Source Repos
 
-By default, `install` targets **all agents**. Use `--agent <name>` to install to a specific one.
+This is still my library, but the upstream lineage stays visible on purpose.
+Some skills track clean upstream mirrors. Others are stable snapshots I keep vendored so installs stay deterministic.
+
+| Source repo | Why it's here | In this library |
+|------------|----------------|-----------------|
+| [Anthropic Skills](https://github.com/anthropics/skills) | The strongest general-purpose skill set in the ecosystem, especially for frontend, docs, and workflow. | 13 skills |
+| [Anthropic Claude Code](https://github.com/anthropics/claude-code) | Extra Claude Code workflow coverage that belongs here when it clears the bar. | 1 skill |
+| [OpenAI Skills](https://github.com/openai/skills) | Strong skills for docs, Figma workflows, browser automation, CI work, and implementation planning. | 7 skills |
+| [wshobson/agents](https://github.com/wshobson/agents) | Strong backend, systems, and architecture coverage. | 7 skills |
+| [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 |
 |-------|------|------------------|
@@ -170,80 +161,94 @@ By default, `install` targets **all agents**. Use `--agent <name>` to install to
 | Goose | `--agent goose` | `~/.config/goose/skills/` |
 | OpenCode | `--agent opencode` | `~/.opencode/skill/` |
 | Letta | `--agent letta` | `~/.letta/skills/` |
-| Portable | `--agent project` | `.skills/` (works with any agent) |
+| Kilo Code | `--agent kilocode` | `~/.kilocode/skills/` |
+| Portable | `--agent project` | `.skills/` |
 
-## Manual Install
+## Commands
 
 ```bash
-# Clone the repo
-git clone https://github.com/skillcreatorai/Ai-Agent-Skills.git
+# Discovery
+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 <owner/repo>
+npx ai-agent-skills install <git-url>
+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
 
-# Copy a skill to your skills directory
-cp -r Ai-Agent-Skills/skills/pdf ~/.claude/skills/
+# Configuration
+npx ai-agent-skills config --default-agent cursor
 ```
 
-## Create Your Own
-
-
-1. **Build manually**: Follow the [Agent Skills spec](https://agentskills.io/specification)
-
-## What Are Agent Skills?
-
-An [open standard from Anthropic](https://agentskills.io) for extending AI agents. A skill is just a folder:
+## Manual Install
 
-```
-my-skill/
-├── SKILL.md       # Instructions + metadata
-├── scripts/       # Optional code
-└── references/    # Optional docs
+```bash
+git clone https://github.com/MoizIbnYousaf/Ai-Agent-Skills.git
+cp -r Ai-Agent-Skills/skills/pdf ~/.claude/skills/
 ```
 
-All major AI coding tools support this format.
-
 ## Contributing
 
-1. Fork this repo
-2. Add your skill to `/skills/<name>/`
-3. Ensure `SKILL.md` follows the [spec](https://agentskills.io/specification)
-4. Update `skills.json`
-5. Submit PR
+This repo is curated. I do not accept everything, and I do not want the catalog to sprawl.
+I would rather keep it small and strong than let it get messy.
 
-We review all contributions for quality and spec compliance.
+Before opening a PR:
 
-## Links
+1. Read [CURATION.md](./CURATION.md).
+2. Follow [CONTRIBUTING.md](./CONTRIBUTING.md).
+3. Add or update the `skills.json` entry.
+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 Spec](https://agentskills.io) - Official format documentation
-- [Browse Skills](https://skillcreator.ai/explore) - Visual skill gallery with one-click install
-- [Create Skills](https://skillcreator.ai/build) - Generate skills (waitlist) 
-- [Anthropic Skills](https://github.com/anthropics/skills) - Official example skills
+Agent skills follow the open format documented at [agentskills.io](https://agentskills.io). A skill is just a folder:
 
-## See Also
+```text
+my-skill/
+├── SKILL.md
+├── scripts/
+└── references/
+```
 
-**[openskills](https://github.com/numman-ali/openskills)** - another universal skills loader that inspired parts of this project (created pre the open agent skills standard) & Requires global install, AGENTS.md sync, and Bash calls. Great for flexibility.
+All major coding agents support some variation of this pattern.
 
-**ai-agent-skills** - Just `npx`, installs to native agent folders. Homebrew for skills.
+## Links
 
----
+- [Agent Skills Spec](https://agentskills.io)
+- [Anthropic Skills](https://github.com/anthropics/skills)
+- [Curation Guide](./CURATION.md)
+- [Contributing Guide](./CONTRIBUTING.md)
+- [Issues](https://github.com/MoizIbnYousaf/Ai-Agent-Skills/issues)
 
 ## Credits & Attribution
 
-This repository builds upon and curates skills from the open-source community:
-
-- **[Anthropic Skills](https://github.com/anthropics/skills)** - Official example skills from Anthropic that established the Agent Skills specification
-- **[ComposioHQ Awesome Claude Skills](https://github.com/ComposioHQ/awesome-claude-skills)** - Curated community skills from the Composio ecosystem
-- **[wshobson/agents](https://github.com/wshobson/agents)** - Development skills inspired by their plugin marketplace patterns
-
-We believe in open source and giving credit where it's due. If you see your work here and want additional attribution, [open an issue](https://github.com/skillcreatorai/Ai-Agent-Skills/issues).
+This library builds on work from the open-source community, especially:
 
-## Community
+- [Anthropic Skills](https://github.com/anthropics/skills)
+- [Anthropic Claude Code](https://github.com/anthropics/claude-code)
+- [OpenAI Skills](https://github.com/openai/skills)
+- [ComposioHQ Awesome Claude Skills](https://github.com/ComposioHQ/awesome-claude-skills)
+- [wshobson/agents](https://github.com/wshobson/agents)
 
-- Follow [@skillcreatorai](https://x.com/skillcreatorai) for updates
-- [Open an issue](https://github.com/skillcreatorai/Ai-Agent-Skills/issues) for bugs or requests
-- [Read CONTRIBUTING.md](./CONTRIBUTING.md) to add skills
+If something here traces back to your work and you want clearer attribution, open an issue.
 
 ---
 
 <p align="center">
-  <sub>Built with care by <a href="https://skillcreator.ai">SkillCreator.ai</a></sub>
+  <sub>Built and curated by <a href="https://github.com/MoizIbnYousaf">Moiz Ibn Yousaf</a></sub>
 </p>

package/WORK_AREAS.md

@@ -0,0 +1,141 @@
+# Work Areas
+
+This is the clean browse map for the library. The folders stay flat under `skills/<name>/` so installs stay simple; the catalog carries the organization.
+
+If you want the fastest CLI shelves, use the collections in the README. If you want to understand the library itself, start here.
+
+## Frontend
+
+Interface systems, React work, and web product execution.
+
+**Coverage:** 3 skills across 3 branches.  
+**Main sources:** OpenAI, Anthropic, Composio
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Figma | [`figma-implement-design`](./skills/figma-implement-design) | OpenAI |
+| React | [`frontend-design`](./skills/frontend-design) | Anthropic |
+| UI | [`artifacts-builder`](./skills/artifacts-builder) | Composio |
+
+## Backend
+
+Infra, tooling, application architecture, and codebase depth.
+
+**Coverage:** 7 skills across 7 branches.  
+**Main sources:** wshobson, Anthropic
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Architecture | [`backend-development`](./skills/backend-development) | wshobson |
+| Database | [`database-design`](./skills/database-design) | wshobson |
+| LLMs | [`llm-application-dev`](./skills/llm-application-dev) | wshobson |
+| MCP | [`mcp-builder`](./skills/mcp-builder) | Anthropic |
+| Python | [`python-development`](./skills/python-development) | wshobson |
+| 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.
+
+**Coverage:** 7 skills across 6 branches.  
+**Main sources:** Anthropic, wshobson, OpenAI
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Writing | [`code-documentation`](./skills/code-documentation), [`doc-coauthoring`](./skills/doc-coauthoring) | Anthropic, wshobson |
+| Documents | [`docx`](./skills/docx) | Anthropic |
+| OpenAI | [`openai-docs`](./skills/openai-docs) | OpenAI |
+| PDF | [`pdf`](./skills/pdf) | Anthropic |
+| Presentations | [`pptx`](./skills/pptx) | Anthropic |
+| Spreadsheets | [`xlsx`](./skills/xlsx) | Anthropic |
+
+## Testing
+
+Review, QA, regression work, and keeping product quality sharp.
+
+**Coverage:** 6 skills across 6 branches.  
+**Main sources:** OpenAI, Moiz, Anthropic Claude Code, Anthropic
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Browser Automation | [`playwright`](./skills/playwright) | OpenAI |
+| CI | [`gh-fix-ci`](./skills/gh-fix-ci) | OpenAI |
+| Observability | [`sentry`](./skills/sentry) | OpenAI |
+| Regression | [`qa-regression`](./skills/qa-regression) | Moiz |
+| Review | [`code-review`](./skills/code-review) | Anthropic Claude Code |
+| Web QA | [`webapp-testing`](./skills/webapp-testing) | Anthropic |
+
+## Workflow
+
+Execution patterns, prompting, ticketing, and operating rhythm.
+
+**Coverage:** 9 skills across 9 branches.  
+**Main sources:** Moiz, Composio, OpenAI, Anthropic
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Clarification | [`ask-questions-if-underspecified`](./skills/ask-questions-if-underspecified) | Moiz |
+| Files | [`file-organizer`](./skills/file-organizer) | Composio |
+| Jira | [`jira-issues`](./skills/jira-issues) | Moiz |
+| Meetings | [`meeting-insights-analyzer`](./skills/meeting-insights-analyzer) | Composio |
+| Planning | [`notion-spec-to-implementation`](./skills/notion-spec-to-implementation) | OpenAI |
+| Prompt Ops | [`best-practices`](./skills/best-practices) | Moiz |
+| Release Notes | [`changelog-generator`](./skills/changelog-generator) | Composio |
+| Skills | [`skill-creator`](./skills/skill-creator) | Anthropic |
+| Utilities | [`raffle-winner-picker`](./skills/raffle-winner-picker) | Composio |
+
+## Research
+
+Competitive scans, discovery work, and synthesis that helps decisions.
+
+**Coverage:** 4 skills across 4 branches.  
+**Main sources:** Composio
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Competitive Intel | [`competitive-ads-extractor`](./skills/competitive-ads-extractor) | Composio |
+| Developer Growth | [`developer-growth-analysis`](./skills/developer-growth-analysis) | Composio |
+| Lead Research | [`lead-research-assistant`](./skills/lead-research-assistant) | Composio |
+| Writing | [`content-research-writer`](./skills/content-research-writer) | Composio |
+
+## Design
+
+Visual systems, thematic work, creative direction, and media craft.
+
+**Coverage:** 7 skills across 7 branches.  
+**Main sources:** Anthropic, OpenAI, Composio
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Canvas | [`canvas-design`](./skills/canvas-design) | Anthropic |
+| Figma | [`figma`](./skills/figma) | OpenAI |
+| Generative Art | [`algorithmic-art`](./skills/algorithmic-art) | Anthropic |
+| GIFs | [`slack-gif-creator`](./skills/slack-gif-creator) | Composio |
+| Images | [`image-enhancer`](./skills/image-enhancer) | Composio |
+| Themes | [`theme-factory`](./skills/theme-factory) | Composio |
+| Video | [`video-downloader`](./skills/video-downloader) | Composio |
+
+## Business
+
+Brand, hiring, ops, and communication work around the product.
+
+**Coverage:** 5 skills across 5 branches.  
+**Main sources:** Anthropic, Moiz, Composio
+
+| Branch | Skills | Sources |
+| --- | --- | --- |
+| Brand | [`brand-guidelines`](./skills/brand-guidelines) | Anthropic |
+| Career | [`job-application`](./skills/job-application) | Moiz |
+| Communication | [`internal-comms`](./skills/internal-comms) | Anthropic |
+| Naming | [`domain-name-brainstormer`](./skills/domain-name-brainstormer) | Composio |
+| Operations | [`invoice-organizer`](./skills/invoice-organizer) | Composio |