ai-workflow-skills

v1.0.7

Published

7 days ago

Interactive CLI to copy ClaudeCode skills into any project

0High
0Medium
0Low

arazaanjum

claude claude-code skills ai cli code-generation

AI Workflow Skills

72 specialized AI skills + base rules + project intelligence — scaffold any project for AI-assisted development in seconds

A comprehensive collection of production-grade AI skills covering frontend, backend, DevOps, database, testing, architecture, AI/ML, and specialized domains. Each skill includes detailed documentation, best practices, and reference files.

📦 Install

Option 1: Claude Code Plugin (Recommended)

Install as a Claude Code plugin — all 72 skills load natively with auto-triggering and slash commands.

# Clone the repo
git clone https://github.com/ARazaAnjum/ClaudeCodeSkilledAgents.git

# Load as a plugin
claude --plugin-dir ./ClaudeCodeSkilledAgents

Available slash commands once loaded:

| Command | Description | |---------|-------------| | /ai-workflow-skills:create-prd [feature] | Generate a Product Requirements Document | | /ai-workflow-skills:generate-tasks [prd-path] | Break a PRD into development tasks | | /ai-workflow-skills:process-tasks [task-path] | Work through a task list step by step |

All 72 skills auto-trigger based on your task — just ask a question and Claude picks the right expert.

Option 2: CLI Setup

Install the CLI globally and scaffold skills into any project:

npm install -g ai-workflow-skills

Option 3: CLI with Plugin Mode

The CLI also supports installing as a plugin into your project:

skills setup

When you select Claude, choose between:

| Mode | What it does | |------|-------------| | Plugin | Copies .claude-plugin/, skills/, ai-workflow/, commands/, and CLAUDE.md — ready to use with claude --plugin-dir . | | Normal skillset | Interactive skill selection — pick only the skills you need |

🚀 Quick Setup

The CLI supports three agents — choose yours at startup:

| | Cursor | Claude (Normal) | Claude (Plugin) | |---|---|---|---| | Project intelligence | cursor.mdc | CLAUDE.md | CLAUDE.md | | Base rules & standards | ai-workflow/ | ai-workflow/ | ai-workflow/ | | Skills | ai-workflow/skills/ (selected) | skills/ (selected) | skills/ (all 72) | | Slash commands | — | — | commands/ | | Plugin manifest | — | — | .claude-plugin/ |

Run from any project directory:

skills setup

The CLI first asks which AI agent you use, then walks you through the setup:

Cursor flow

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  AI Workflow Skills Setup
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

? Which AI agent are you using?  →  Cursor

Step 1 — cursor.mdc (Project Intelligence)
  ✓ cursor.mdc  →  /your-project/cursor.mdc

Step 2 — How would you like to set up Claude skills?
  ✓ Plugin 
  ✓ Normal Skillset


Step 2 — Base rules & standards
  ? Copy base rules and standards (ai-workflow) into the project? (Y/n)
  ✓ ai-workflow  →  /your-project/ai-workflow

Step 3 — Skills
  ? Do you want to copy skills into ai-workflow/skills/? (Y/n)
  ? Select one or more skills to copy:   ← checkbox list of 69 skills
  ✓ react-expert, typescript-pro, test-master …

  Code ends. Intelligence continues.

Claude flow

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  AI Workflow Skills Setup
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

? Which AI agent are you using?  →  Claude

Step 1 — CLAUDE.md (Project Intelligence)
  ✓ CLAUDE.md  →  /your-project/CLAUDE.md

Step 2 — Base rules & standards
  ? Copy base rules and standards (ai-workflow) into the project? (Y/n)
  ✓ ai-workflow  →  /your-project/ai-workflow

Step 3 — Skills
  ? Do you want to copy skills into skills/? (Y/n)
  ? Select one or more skills to copy:   ← checkbox list of 69 skills
  ✓ react-expert, typescript-pro, test-master …

  Code ends. Intelligence continues.

After setup — Cursor project

your-project/
├── cursor.mdc                            # Teaches Cursor to discover skills & rules
├── ai-workflow/
│   ├── process/                          # Workflow templates
│   │   ├── create-prd.md                 #   Generate a Product Requirements Doc
│   │   ├── generate-tasks.md             #   Break a PRD into dev tasks
│   │   └── process-task-list.md          #   Work through tasks one by one
│   ├── rules/                            # Coding standards
│   │   ├── common-rules/                 #   Universal dev standards
│   │   └── framework-specific-rules/     #   React, Vue, Laravel, Flutter, Node.js …
│   └── skills/                           # Skills live inside ai-workflow
│       ├── react-expert/
│       ├── typescript-pro/
│       └── …
└── (your code)

After setup — Claude project

your-project/
├── CLAUDE.md                             # Teaches Claude to discover skills & rules
├── ai-workflow/
│   ├── process/                          # Workflow templates
│   │   ├── create-prd.md                 #   Generate a Product Requirements Doc
│   │   ├── generate-tasks.md             #   Break a PRD into dev tasks
│   │   └── process-task-list.md          #   Work through tasks one by one
│   └── rules/                            # Coding standards
│       ├── common-rules/                 #   Universal dev standards
│       └── framework-specific-rules/     #   React, Vue, Laravel, Flutter, Node.js …
├── skills/                               # Skills at project root
│   ├── react-expert/
│   │   ├── SKILL.md                      # Role, triggers, workflow, constraints
│   │   └── references/                   # Patterns, examples, best practices
│   ├── typescript-pro/
│   └── …
└── (your code)

🔌 Claude Code Plugin

This project is also available as a Claude Code plugin. Instead of copying skills into your project, you can load them directly into Claude Code.

Install as a plugin (local)

# Load directly from a local clone
claude --plugin-dir /path/to/ai-workflow-skills

Install from marketplace

# If published to a marketplace
claude plugin install ai-workflow-skills

What you get

Once installed, the plugin provides:

72 auto-triggered skills — Claude automatically uses the right skill based on your task (React, Python, DevOps, etc.)
3 slash commands for structured workflows:
- /ai-workflow-skills:create-prd — Generate a Product Requirements Document
- /ai-workflow-skills:generate-tasks — Break a PRD into development tasks
- /ai-workflow-skills:process-tasks — Work through a task list step by step
Development rules — Coding standards applied automatically as background knowledge

Plugin structure

ai-workflow-skills/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest
├── skills/                      # 72 auto-triggered skills
│   ├── react-expert/
│   │   ├── SKILL.md             # Skill definition
│   │   └── references/          # Supporting docs
│   ├── python-pro/
│   └── ...
├── commands/                    # User-invocable slash commands
│   ├── create-prd.md
│   ├── generate-tasks.md
│   └── process-tasks.md
└── README.md

Testing the plugin

# Start Claude Code with the plugin loaded
claude --plugin-dir .

# Try a slash command
/ai-workflow-skills:create-prd my-new-feature

# Or just ask a question — skills trigger automatically
> Help me build a React component with sorting
# → Claude loads react-expert skill automatically

🧠 How It Works

CLAUDE.md — Project Intelligence

The CLAUDE.md file is read by Claude at the start of every conversation. It tells Claude to:

Scan skills/ for a matching skill based on trigger keywords in your request
Read the full SKILL.md and references/ before writing any code
Follow ai-workflow/rules/ coding standards for your tech stack
Use ai-workflow/process/ workflows for feature planning (PRD → tasks → implementation)

Skills — How Claude Matches Them

Each skill has YAML frontmatter with triggers. Claude automatically matches your request:

| You ask about… | Claude reads… | |---|---| | React, hooks, JSX, components | skills/react-expert/ | | Vue, Composition API, Pinia | skills/vue-expert/ | | Next.js, App Router, RSC | skills/nextjs-developer/ | | Python, type hints, async | skills/python-pro/ | | FastAPI, Pydantic | skills/fastapi-expert/ | | Django, DRF, ORM | skills/django-expert/ | | TypeScript, advanced types | skills/typescript-pro/ | | Testing, TDD | skills/test-master/ | | PostgreSQL, SQL, queries | skills/postgres-pro/ | | Docker, CI/CD, deployment | skills/devops-engineer/ | | Kubernetes, Helm | skills/kubernetes-specialist/ | | AWS, GCP, Azure | skills/cloud-architect/ | | REST API, GraphQL, OpenAPI | skills/api-designer/ | | Architecture, system design | skills/architecture-designer/ | | Security, vulnerabilities | skills/security-reviewer/ | | Debugging, errors | skills/debugging-wizard/ |

Each matched skill gives Claude: a role definition, a 5-step workflow, reference docs, MUST DO / MUST NOT DO constraints, and output templates.

ai-workflow/ — Rules & Process

Process files give Claude structured workflows:

| File | When to use | |---|---| | create-prd.md | User wants to plan a new feature — Claude asks clarifying questions, generates a PRD | | generate-tasks.md | After a PRD exists — Claude breaks it into numbered dev tasks | | process-task-list.md | During implementation — Claude works through tasks one at a time |

Rule files enforce coding standards:

| Rules | Coverage | |---|---| | common-rules/ | Universal development standards, cursor usage | | framework-specific-rules/react.mdc | React component patterns, hooks, state | | framework-specific-rules/vue/ | Vue 3, Composition API, Pinia | | framework-specific-rules/laravel/ | Laravel architecture, Eloquent, APIs | | framework-specific-rules/flutter/ | Flutter widgets, BLoC, Riverpod | | framework-specific-rules/nodejs.mdc | Node.js patterns | | framework-specific-rules/reactNative.mdc | React Native mobile | | framework-specific-rules/nextjs-supabase-auth.mdc | Next.js + Supabase auth |

🔧 CLI Reference

Commands

skills setup                    # Interactive 3-step project setup (default)
skills list                     # Print all 69 available skills
skills list --search python     # Filter by name
skills --version                # Show version
skills --help                   # Show help

Setup flags

skills setup --dry-run          # Preview what would be copied — writes nothing
skills setup --force            # Overwrite existing folders without asking
skills setup --all              # Copy all 69 skills without the checkbox prompt
skills setup --search react     # Pre-filter the skill list before selecting

Conflict handling

If a folder or file already exists in your project you will be prompted to choose:

Overwrite — replaces the existing folder/file
Skip — leaves it untouched
Rename — copies as <name>-1, <name>-2, etc.

📚 Using Skills Directly

Using Skills in Claude

Reference any skill directly in your Claude conversation:

@react-expert
Help me build a data table component with sorting and filtering

@python-pro
Create a type-safe async API client

@devops-engineer
Set up a CI/CD pipeline with GitHub Actions

Using Agent CLI

# List all agents
node agents/cli.js list

# Search for agents
node agents/cli.js search react

# Get agent info
node agents/cli.js info react-expert

# Show statistics
node agents/cli.js stats

# Get recommendations
node agents/cli.js recommend web-app

Using TypeScript Agents

import { react_expertAgent } from './agents/typescript/react-expert.agent';

// Check if agent matches
if (react_expertAgent.shouldTrigger('build a React component')) {
  // Execute the agent
  const result = await react_expertAgent.execute({
    task: 'Create sortable data table',
    requirements: ['TypeScript', 'Responsive']
  });
}

Using Agent Router

import AgentRouter from './agents/typescript/agent-router';

const router = new AgentRouter();

// Automatically find and execute the best agent
await router.route('Help me optimize my PostgreSQL queries');
// → Routes to: postgres-pro

📁 Repository Structure

ClaudeCodeSkills/
├── skills/                 # 69 skill definitions
│   ├── react-expert/
│   │   ├── SKILL.md        # Main skill definition
│   │   └── references/     # Supporting documentation
│   ├── python-pro/
│   ├── devops-engineer/
│   └── ...
│
├── agents/                 # Generated agent files
│   ├── typescript/         # TypeScript agents (69 files)
│   ├── json/               # JSON configs (69 files)
│   ├── cli.js              # Command-line interface
│   ├── package.json        # NPM configuration
│   └── README.md           # Agent documentation
│
├── generate-agents.js      # Agent generator script
├── PROJECT_SUMMARY.md      # Detailed project summary
└── README.md               # This file

🎯 Available Skills

Frontend Development (10)

| Skill | Description | |-------|-------------| | react-expert | React 18+ applications, hooks, Server Components, React 19 | | vue-expert | Vue 3 Composition API with TypeScript | | vue-expert-js | Vue 3 Composition API with JavaScript | | angular-architect | Angular applications with RxJS and NgRx | | nextjs-developer | Next.js App Router with Server Components | | react-native-expert | React Native mobile development | | flutter-expert | Flutter cross-platform apps | | frontend-design | Creative frontend design with bold aesthetics | | typescript-pro | TypeScript with advanced typing | | javascript-pro | Modern JavaScript development |

Backend Development (17)

| Skill | Description | |-------|-------------| | python-pro | Python 3.11+ with type safety and async | | fastapi-expert | FastAPI async APIs | | django-expert | Django web framework | | nestjs-expert | NestJS TypeScript framework | | rails-expert | Ruby on Rails | | golang-pro | Go backend development | | java-architect | Java enterprise applications | | spring-boot-engineer | Spring Boot microservices | | php-pro | Modern PHP development | | laravel-specialist | Laravel framework | | dotnet-core-expert | .NET Core applications | | csharp-developer | C# development | | rust-engineer | Rust systems programming | | cpp-pro | Modern C++ development | | kotlin-specialist | Kotlin development | | swift-expert | Swift and iOS development | | backend-patterns | Backend design patterns |

DevOps & Infrastructure (7)

| Skill | Description | |-------|-------------| | devops-engineer | CI/CD, Docker, deployment automation | | kubernetes-specialist | Kubernetes orchestration | | terraform-engineer | Infrastructure as Code | | cloud-architect | AWS/GCP/Azure architecture | | sre-engineer | Site Reliability Engineering | | monitoring-expert | Observability and monitoring | | chaos-engineer | Chaos engineering practices |

Database & Data (5)

| Skill | Description | |-------|-------------| | database-optimizer | Database performance tuning | | postgres-pro | PostgreSQL expertise | | sql-pro | SQL query optimization | | pandas-pro | Pandas data analysis | | spark-engineer | Apache Spark data processing |

Testing & Quality (6)

| Skill | Description | |-------|-------------| | test-master | Comprehensive testing strategies | | tdd-workflow | Test-driven development | | playwright-expert | E2E testing with Playwright | | code-reviewer | Code review and quality audits | | security-reviewer | Security audits and vulnerability assessment | | secure-code-guardian | Secure coding practices |

Architecture & Design (4)

| Skill | Description | |-------|-------------| | architecture-designer | System architecture and design | | api-designer | RESTful and GraphQL API design | | microservices-architect | Microservices patterns | | graphql-architect | GraphQL schema design |

AI & Machine Learning (4)

| Skill | Description | |-------|-------------| | prompt-engineer | LLM prompt engineering | | fine-tuning-expert | Model fine-tuning | | ml-pipeline | ML pipeline development | | rag-architect | RAG system architecture |

Specialized (8)

| Skill | Description | |-------|-------------| | mcp-developer | Model Context Protocol development | | websocket-engineer | Real-time WebSocket applications | | cli-developer | CLI tool development | | game-developer | Game development | | embedded-systems | Embedded systems programming | | shopify-expert | Shopify development | | wordpress-pro | WordPress development | | salesforce-developer | Salesforce development |

Utilities & Process (8)

| Skill | Description | |-------|-------------| | fullstack-guardian | Full-stack feature development | | feature-forge | Feature implementation workflow | | legacy-modernizer | Legacy code modernization | | debugging-wizard | Debugging assistance | | code-documenter | Documentation generation | | spec-miner | Requirements gathering | | coding-standards | Code standards enforcement | | atlassian-mcp | Atlassian tools integration |

🔧 Features

✅ Consistent Structure

Every skill follows a proven format:

YAML frontmatter with metadata
Role definition with expertise level
Clear use cases and triggers
5-step core workflow
Reference guide with supporting docs
MUST DO / MUST NOT DO constraints
Output templates
Related skills cross-references

📚 Rich Documentation

69 comprehensive SKILL.md files
356 reference documents
Production-grade code examples
Best practices and anti-patterns
Architectural patterns
Testing strategies

🤖 Auto-Generated Agents

69 TypeScript agent files
69 JSON configuration files
Intelligent auto-triggering
Smart routing system
Multi-format support

🎯 Smart Routing

Automatic agent selection
Multi-trigger matching with scoring
Priority-based routing by role
Search and filter capabilities
Category-based discovery

🛠️ Developer Tools

CLI for easy agent interaction
TypeScript Agent Router
JSON registry for all agents
Example usage patterns
Regeneration script

📊 Statistics

Total Skills: 69
Total Agents: 138 (TypeScript + JSON)
Reference Files: 356
Total Documentation: 425+ markdown files
Agent Roles: 4 (specialist, architect, expert, engineer)
Agent Scopes: 10+ (implementation, design, testing, etc.)
Output Formats: 10+ (code, document, report, etc.)

🎨 Agent Roles

Specialist (48 agents)

Deep expertise in specific technologies and frameworks.

Architect (6 agents)

System design, architecture patterns, and technical decision-making.

Expert (11 agents)

Domain expertise, consulting, and advanced techniques.

Engineer (4 agents)

Implementation, operations, and platform engineering.

🔄 Regenerating Agents

After modifying any SKILL.md files:

node generate-agents.js

This will:

Parse all SKILL.md files
Extract YAML frontmatter
Generate TypeScript agent files
Generate JSON config files
Create index files for imports
Report any errors

💡 Usage Examples

Example 1: Building a Web Application

import AgentRouter from './agents/typescript/agent-router';

const router = new AgentRouter();

// Architecture phase
await router.route('Design architecture for e-commerce platform');

// API design phase
await router.route('Design REST API for products and orders');

// Implementation phase
await router.route('Build FastAPI application with async endpoints');

// Testing phase
await router.route('Create comprehensive test suite with pytest');

// Deployment phase
await router.route('Set up CI/CD pipeline with Docker and Kubernetes');

Example 2: Finding the Right Agent

// Search by technology
router.searchAgents('react');
router.searchAgents('kubernetes');
router.searchAgents('database');

// Filter by role
router.getAgentsByRole('architect');

// Filter by scope
router.getAgentsByScope('implementation');

// Get specific agent
const agent = router.getAgent('react-expert');

Example 3: Using CLI

# List all frontend agents
node agents/cli.js list --search=frontend

# Get recommendations for web app
node agents/cli.js recommend web-app

# Show agent details
node agents/cli.js info react-expert

# View statistics
node agents/cli.js stats

🚀 Common Workflows

Web Application Development

architecture-designer - Design system architecture
api-designer - Design API endpoints
react-expert - Build frontend
fastapi-expert - Build backend
postgres-pro - Design database
test-master - Create test suite
devops-engineer - Set up deployment

API Development

api-designer - Design API contract
fastapi-expert / nestjs-expert - Implement API
database-optimizer - Optimize queries
test-master - Add integration tests
security-reviewer - Security audit
code-documenter - Generate API docs

Performance Optimization

debugging-wizard - Identify bottlenecks
database-optimizer - Optimize queries
monitoring-expert - Set up observability
chaos-engineer - Test resilience
code-reviewer - Review optimizations

📖 Documentation

Project Summary - Comprehensive project overview
Agent Documentation - How to use agents
Skills Directory - Individual skill documentation
Example Usage - TypeScript examples

🤝 Contributing

To add a new skill:

Create directory: skills/your-skill-name/
Create SKILL.md with proper YAML frontmatter
Add reference files in references/ subdirectory
Regenerate agents: node generate-agents.js
Test with CLI: node agents/cli.js info your-skill-name

Skill Template

---
name: your-skill-name
description: Brief description of what this skill does
triggers:
  - keyword1
  - keyword2
  - keyword3
role: specialist|architect|expert|engineer
scope: implementation|design|testing|infrastructure
output-format: code|document|report
---

# Your Skill Name

Brief introduction...

## Role Definition
...

## When to Use This Skill
...

## Core Workflow
...

## Reference Guide
...

## Constraints
...

## Output Templates
...

## Knowledge Reference
...

## Related Skills
...

🔍 Finding Skills

By Technology

node agents/cli.js search react
node agents/cli.js search python
node agents/cli.js search kubernetes

By Role

node agents/cli.js list --role=architect
node agents/cli.js list --role=specialist

By Scenario

node agents/cli.js recommend web-app
node agents/cli.js recommend devops
node agents/cli.js recommend api

📝 License

MIT License - See LICENSE file for details

🙏 Acknowledgments

Built with inspiration from production-grade software engineering practices and the Claude Agent SDK.

📧 Support

Issues: Create an issue in the repository
Discussions: Start a discussion for questions
CLI Help: node agents/cli.js help

🚀 Ready to use? Start with @react-expert or run node agents/cli.js recommend web-app

📊 Stats: 69 skills | 138 agents | 356 references | 425+ docs

🔄 Last Updated: 2026-02-03