Awesome AI Agent Skills

A community-shared collection of reusable skills for AI coding agents. Works with Claude Code, Cursor, Kilo Code, Windsurf, OpenAI Codex, and any AI tools that support skills or custom instructions.

What are Skills?

Skills are self-contained instruction sets that teach AI agents specific workflows, guidelines, or capabilities. Each skill includes:

• A SKILL.md with metadata and instructions
• Optional reference documentation for detailed guidance
• Reusable across any project

Installation

Claude Code

Step 1: Add the marketplace

/plugin marketplace add thienanblog/awesome-ai-agent-skills

Step 2: Install skills

# Install a plugin (can bundle multiple skills)
/plugin install documentation-skills@awesome-ai-agent-skills

# Install Laravel guidelines
/plugin install laravel-app-skills@awesome-ai-agent-skills

# Install Docker local development skill
/plugin install devops-skills@awesome-ai-agent-skills

# Install workflow/clarification skill
/plugin install workflow-skills@awesome-ai-agent-skills

# Install office web UI skill
/plugin install office-web-ui-skills@awesome-ai-agent-skills

# Install UI mockup and wireframe skill
/plugin install ui-design-skills@awesome-ai-agent-skills

Updating the marketplace

/plugin marketplace update

OpenAI Codex / Other AI Tools

Clone or reference this repository and point your AI tool to the skills/ directory. Each skill follows a standard format with SKILL.md containing the instructions.

git clone https://github.com/thienanblog/awesome-ai-agent-skills.git

Manual Usage

You can also copy individual skill instructions directly into your AI agent's context or system prompt.

Available Skills

Skill	Author	Description
agents-md-generator	Official	Generate or update CLAUDE.md/AGENTS.md files for AI coding agents through auto-scanning project files combined with interactive Q&A. Supports multiple tech stacks, development environments, and preserves customizations when updating.
ask-questions-if-underspecified	Tibo (Codex Team)	Clarify requirements before implementing. Do not use automatically, only when invoked explicitly.
design-system-generator	Official	Generate a project-specific DESIGN_SYSTEM.md that enforces consistent UI/UX across SPAs, traditional server-rendered sites, and hybrid systems. Includes tokens, component rules, accessibility gates, and production asset/manifest guidance.
docker-local-dev	Official	Generate Docker Compose and Dockerfile configurations for local development through interactive Q&A. Supports PHP/Laravel, WordPress, Drupal, Joomla, Node.js, and Python stacks with Nginx, Supervisor/PM2, databases, Redis, and email testing. Always asks clarifying questions before generating configurations.
documentation-guidelines	Official	Write or update backend feature documentation that follows a repo's DOCUMENTATION_GUIDELINES.md (or equivalent) across any project. Use when asked to create/update module docs, API contracts, or backend documentation that must include architecture, endpoints, payloads, Mermaid diagrams, and seeding instructions.
find-scene	—	Search movie and TV show scenes by dialog, time, or visual description. Download video clips, extract frames, find quotes, identify movies from quotes, and query IMDB data. Use when the user wants to find a specific scene, download a clip, search for a quote in a movie/show, extract a frame, or get movie information via the find-scene API.
laravel-11-12-app-guidelines	Official	Guidelines and workflow for working on Laravel 11 or Laravel 12 applications across common stacks (API-only or full-stack), including optional Docker Compose/Sail, Inertia + React, Livewire, Vue, Blade, Tailwind v4, Fortify, Wayfinder, PHPUnit, Pint, and Laravel Boost MCP tools. Use when implementing features, fixing bugs, or making UI/backend changes while following project-specific instructions (AGENTS.md, docs/).
noizai-voice-workflow	—	Build human-like TTS voice workflows with style controls, local/cloud backends, and delivery-ready output. Use when the user needs expressive text-to-speech generation, voice broadcast assets, or app-ready voice messages.
office-web-ui-system	Official	Design and refactor polished office-style web app interfaces for admin, internal, and back-office products. Use when an AI agent needs to build or improve dashboards, stat cards, page heroes, filter/search bars, data tables, shells, side panels, semantic locator classes, or reusable page composition that stays portable across Vue, React, Laravel, and other web stacks with or without PrimeVue.
symcli-skill	Wowo51	Execute SymCLI to solve math equations, optimize tensor graphs, or analyze C# code for vulnerabilities. Turn your coding agent into an AI mathematician, SymbolicComputation.com
ui-mockup-visualizer	Official	Create fixed-canvas HTML mockups for websites, mobile apps, and desktop apps so an AI agent can verify UI direction before implementation. Use when a user asks for layout ideas, wireframes, visual comparison, HTML previews, mockups, or wants to see what a sidebar, navbar, modal, dashboard section, mobile screen, or desktop panel could look like. This skill always proposes Option A, Option B, and Option C with one recommended option, mirrors the user's language in the review, uses Svelte CDN plus TailwindCSS CDN templates, starts a local preview server, captures screenshot checkpoints of the mockup region only, and turns an approved option into an implementation-ready plan.
vps-docker-traefik-deploy	Official	Plan and implement secure production deployments of Docker Compose applications on self-hosted VPS or cloud servers using Docker Engine, Docker Compose, Traefik, private registries, SSH tunnels, least-privilege users, persistent volumes, backups, DNS, and storage growth planning. Use when an AI agent needs to design, review, document, or execute a real deploy for websites, APIs, websockets, workers, databases, and object storage integrations on Ubuntu or Debian style Linux hosts.

Plugin Groups

Plugins bundle related skills so you can install by domain. The source of truth is plugin-groups.json.

Plugin	Description	Skills
documentation-skills	Skills for authoring AI agent instructions, backend documentation, and design systems.	agents-md-generator documentation-guidelines design-system-generator
laravel-app-skills	Guidelines for building Laravel 11/12 apps across common stacks and tooling.	laravel-11-12-app-guidelines
devops-skills	Skills for Docker, CI/CD, and local development environment configuration.	docker-local-dev vps-docker-traefik-deploy
workflow-skills	Skills for AI agent workflow and requirements clarification processes.	ask-questions-if-underspecified
media-skills	Skills for searching, downloading, and processing video and media content.	find-scene noizai-voice-workflow
office-web-ui-skills	Skills for designing and refactoring admin, internal, and back-office web interfaces.	office-web-ui-system
ui-design-skills	Skills for visualizing UI ideas as reviewable mockups and wireframes across web, mobile, and desktop apps.	ui-mockup-visualizer
math-and-reasoning-skills	Skills for solving complex math, logic, and tensor optimization problems precisely.	symcli-skill

Contributing

We welcome contributions! Here's a quick start:

1. Fork this repository
2. Create a skill folder: skills/your-skill-name/
3. Add a SKILL.md with metadata:

   ---
   name: your-skill-name
   description: What the skill does and when to use it.
   author: Your Name or Team
   ---
   

4. Add the skill to plugin-groups.json so it belongs to exactly one plugin.
5. Sync and validate locally before pushing:

   npm install
   npm run sync
   npm run validate
   

6. Submit a pull request

See CONTRIBUTING.md for detailed guidelines, validation instructions, and troubleshooting.

Validation Workflow

• plugin-groups.json is the source of truth for plugin membership.
• npm run sync regenerates .claude-plugin/marketplace.json and the generated tables in README.md.
• npm run validate checks skill metadata, plugin assignments, and marketplace/plugin consistency.
• Pull request CI reruns npm run sync and fails if generated files are out of date.

For AI Agents

See CLAUDE.md (or AGENTS.md) for instructions on how to work with this repository, including how to group skills into plugins and update the marketplace when new skills are added.

Compatibility

This skill format is designed to be universal and works with:

• Claude Code (Anthropic)
• OpenAI Codex
• Cursor
• Kilo Code
• GitHub Copilot
• Windsurf
• Any AI coding assistant that supports custom instructions or skills

Known Limitations

• Claude Code currently indexes skills from the repository root, so /skills can list all marketplace skills even if you installed only one plugin. This is a Claude Code limitation. We follow the official Claude Skills marketplace example and keep source: "./" with explicit skills lists so plugin boundaries remain clear and other tools can scope installs properly. If /skills looks larger than expected, use the plugin skills list and the tables above as the source of truth.

License

MIT