Agentic Workflows

Universal workflows, skills, and MCP servers for AI IDE agents (Kiro, Qoder, Amazon Q, Claude, etc.)

🎯 What is this?

A collection of reusable agentic workflows that work across multiple AI IDE agents:

• Skills - Specialized capabilities (browser automation, app runner, etc.)
• Steering - Project context and coding standards
• MCP Servers - Tool integrations (Playwright, database, etc.)
• Templates - Reasoning chains, agent patterns

📦 Installation

Quick Install (Recommended)

# Clone repo
git clone https://github.com/YOUR_USERNAME/agentic-workflows.git
cd agentic-workflows

# Install for your IDE
./install.sh --ide kiro
./install.sh --ide qoder
./install.sh --ide amazonq
./install.sh --ide all  # Install for all IDEs

Manual Install

# For Kiro
cp -r skills ~/.kiro/
cp -r steering ~/.kiro/
cp -r mcp-servers ~/.kiro/
cp settings/mcp.json ~/.kiro/settings/

# For Qoder
cp -r skills ~/.qoder/
cp -r steering ~/.qoder/
cp -r mcp-servers ~/.qoder/
cp settings/mcp.json ~/.qoder/settings/

📁 Structure

agentic-workflows/
├── skills/                    # Reusable skills
│   ├── empa-app-runner.md
│   ├── ui-ux-constitution.md
│   └── browser-automation.md
│
├── steering/                  # Project guidelines
│   ├── coding-standards.md
│   ├── python-best-practices.md
│   └── react-patterns.md
│
├── mcp-servers/              # MCP tool servers
│   ├── browser-automation/
│   │   ├── server.py
│   │   ├── pyproject.toml
│   │   └── README.md
│   ├── database-query/
│   └── file-operations/
│
├── templates/                # Code templates
│   ├── reasoning-chain.py
│   ├── agent-pattern.py
│   └── mcp-server-template.py
│
├── examples/                 # Example skills (reference only, not installed)
│   ├── empa-app-runner/
│   └── ui-ux-constitution/
│
├── settings/                 # Config templates
│   ├── mcp.json
│   └── config.json
│
├── install.sh               # Installation script
├── uninstall.sh             # Uninstallation script
└── README.md

🚀 Usage

After Installation

Your IDE will automatically load:

• Skills from ~/.{ide}/skills/
• Steering from ~/.{ide}/steering/
• MCP servers from ~/.{ide}/mcp-servers/

Example: Browser Automation

User: "Open http://localhost:8000 and take a screenshot"

Agent will use browser-automation MCP server:
1. navigate(url="http://localhost:8000")
2. screenshot(path="screenshot.png")

Example: App Runner

User: "Run the Empa app"

Agent will use empa-app-runner skill:
1. cd app && uv run app.py
2. Wait for server start
3. Open browser to localhost:8000

🔧 Customization

Add Your Own Skills

# Create new skill
cat > skills/my-custom-skill.md << 'EOF'
# My Custom Skill

## Purpose
What this skill does

## Usage
How to use it
EOF

# Reinstall
./install.sh --ide kiro

Add Your Own MCP Server

# Create new MCP server
mkdir mcp-servers/my-server
cd mcp-servers/my-server

# Create server.py
cat > server.py << 'EOF'
from mcp.server.fastmcp import FastMCP

mcp = FastMCP("my-server")

@mcp.tool()
def my_tool(arg: str) -> str:
    """My custom tool"""
    return f"Result: {arg}"
EOF

# Create pyproject.toml
cat > pyproject.toml << 'EOF'
[project]
name = "my-server-mcp"
version = "0.1.0"
dependencies = ["mcp[cli]>=1.0.0"]
EOF

# Install dependencies
uv sync

# Reinstall
cd ../..
./install.sh --ide kiro

🎨 Supported IDEs

IDE	Status	Notes
Kiro	✅ Full support	Skills, Steering, MCP
Qoder	✅ Full support	VS Code extension
Amazon Q	🚧 Partial	MCP only
Claude Desktop	🚧 Partial	MCP only (global config)
Cursor	🚧 Partial	MCP only

📚 Available Skills

• empa-app-runner - Auto-run Empa app with browser
• ui-ux-constitution - UI/UX design system for HSP-friendly apps
• browser-automation - Control browser via Playwright

🔌 Available MCP Servers

• browser-automation - Playwright browser control

  • Navigate, click, fill forms, screenshot
  • 143 device emulation profiles

• database-query - SQL database operations (coming soon)

• file-operations - Advanced file management (coming soon)

🛠️ Development

Testing MCP Servers

cd mcp-servers/browser-automation
uv run mcp dev server.py

Open http://localhost:5173 to test interactively.

Contributing

1. Fork the repo
2. Create feature branch
3. Add your skill/server/template
4. Test with ./install.sh --ide kiro
5. Submit PR

📖 Documentation

• Creating Skills
• Creating MCP Servers
• Reasoning Patterns
• Multi-Domain Architecture

🔄 Updates

# Update to latest
cd agentic-workflows
git pull
./install.sh --ide kiro  # Reinstall

🗑️ Uninstall

./uninstall.sh --ide kiro
./uninstall.sh --ide all

📝 License

MIT

🤝 Credits

Created for universal AI IDE agent workflows.