AI Workflow Collection - AI Instructions

This is the master repository for curated Claude Code workflow collections.

Language Guidelines

IMPORTANT: All AGENTS.md files in this project MUST be written in English only. This ensures consistent AI behavior across different language contexts.

• AGENTS.md - English only (AI instructions)
• README.md - English (primary)
• README_cn.md - Chinese translation (optional)

Project Structure

ai-workflow/
├── AGENTS.md              # This file (AI context)
├── README.md              # User documentation (update after creating workflows)
├── .claude/skills/        # Shared skills for this project
│   ├── workflow-creator/  # Create new workflows
│   └── skill-creator/     # Create new skills
├── workflows/
│   ├── content-creator-workflow/   # Example workflow
│   ├── marketing-pro-workflow/     # Example workflow
│   └── <new-workflow>/             # New workflows created here

Available Skills

workflow-creator

Trigger: "create workflow", "new workflow", "set up workflow", "build a xxx-workflow"

Creates complete workflow directories with:

• Multi-AI tool support (.claude, .codex, .cursor, .opencode, .agents, .kilocode, .roo, .goose, .gemini, .agent, .github, skills, .factory, .windsurf)
• Curated skills downloaded from GitHub
• README.md (user documentation)
• AGENTS.md (AI instructions)

skill-creator

Trigger: "create skill", "new skill", "build a skill"

Creates new skills following Anthropic's specification.

Workflow Creation Process

When user requests a new workflow:

1. Create directory using workflow-creator/scripts/create_workflow.py (default target: workflows/)
2. Select skills from workflow-creator/references/skill-sources.md
3. Download skills using workflow-creator/scripts/download_skill.py
4. Generate README.md for users
5. Generate AGENTS.md for AI
6. Update project README.md - Add new workflow to the list

Post-Creation Tasks

After creating any workflow, ALWAYS update the project README.md:

1. Add new workflow to the workflow list table
2. Update workflow count
3. Add brief description

Output Standards

Workflow Directory Structure

workflows/<workflow name>/
├── README.md              # User documentation
├── AGENTS.md              # AI instructions (concise, <500 lines)
├── .claude/
│   ├── settings.json
│   └── skills/            # Downloaded skills (primary storage)
├── .codex/
│   └── skills -> ../.claude/skills
├── .cursor/
│   └── skills -> ../.claude/skills
├── .opencode/
│   └── skill -> ../.claude/skills
├── .agents/
│   └── skills -> ../.claude/skills
├── .kilocode/
│   └── skills -> ../.claude/skills
├── .roo/
│   └── skills -> ../.claude/skills
├── .goose/
│   └── skills -> ../.claude/skills
├── .gemini/
│   └── skills -> ../.claude/skills
├── .agent/
│   └── skills -> ../.claude/skills
├── .github/
│   └── skills -> ../.claude/skills
├── skills -> .claude/skills
├── .factory/
│   └── skills -> ../.claude/skills
└── .windsurf/
    └── skills -> ../.claude/skills

README.md Content

• Workflow purpose and target users
• Installed skills table
• Quick start guide
• Usage examples

AGENTS.md Content

• Workflow overview
• Available skills with triggers
• Recommended workflow steps
• Skill usage guidelines

Skill Sources Priority

1. Anthropic Official: github.com/anthropics/skills
2. Curated Community: Listed in skill-sources.md
3. Dynamic Search: GitHub search as fallback

Quality Checklist

Before completing workflow creation:

• All skills have valid SKILL.md
• Symlinks work for all AI tools
• README.md is complete
• AGENTS.md is concise and actionable
• Project README.md updated with new workflow