Workflow Creator

Create complete workflow directories with curated skills downloaded from GitHub.

Workflow Creation Process

Step 1: Create directory structure

Run

scripts/create_workflow.py

to initialize:

bash

python scripts/create_workflow.py <workflow-name> --path <output-dir>

Creates (with multi-AI tool support):

workflows/<workflow-name>-workflow/
├── README.md          # User documentation (English)
├── README_cn.md       # User documentation (Chinese)
├── AGENTS.md          # AI context (auto-loaded)
├── .claude/
│   ├── settings.json
│   └── skills/        # Skills go here (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

Symlinks enable all AI tools to use the same skills from .claude/skills/.

Step 2: Select and download skills

Use the Skill Sources section below to find relevant skills
Download each skill using
```
scripts/download_skill.py
```
:

bash

python scripts/download_skill.py <repo-url> <skill-path> --output workflows/<workflow-name>/.claude/skills/

Examples:

bash

# Official Anthropic skills
python scripts/download_skill.py https://github.com/anthropics/skills skills/docx --output ./workflows/media-workflow/.claude/skills/

# Community skills (root level)
python scripts/download_skill.py https://github.com/gked2121/claude-skills social-repurposer --output ./workflows/media-workflow/.claude/skills/

Step 3: Generate README.md (English)

CRITICAL: Follow the exact format from
workflows/marketing-pro-workflow/README.md

Required structure:

markdown

<div align="center">

# 📋 Workflow Name

### **Your AI-Powered [Domain] Team**

[← Back to AI Workflow](../../README.md)

[简体中文](./README_cn.md) | English

</div>

---

## 🎯 Who Is This For?
- **Role 1** - Use case
- **Role 2** - Use case

---

## ⚡ Quick Install
[Install commands]

---

## 📦 Skills Included (N)

### 0️⃣ Stage Name
| Skill | What It Does |
|:------|:-------------|
| `skill-name` | Description |

### 1️⃣ Next Stage
...

---

## 🔄 Complete Pipeline (N Stages)
[ASCII tree diagram]

---

## 💡 Example Workflows
[Multiple scenario examples with numbered prompts]

---

## 🔗 Skill Combinations
[Table with Goal → Skill Chain]

---

## 📄 License
MIT © [nicepkg](https://github.com/nicepkg)

Use

assets/templates/README.template.md

as reference.

Step 4: Generate README_cn.md (Chinese)

Create Chinese version with:

Same structure as English README
Professional Chinese terminology
Link back to
```
../../README_cn.md
```

Step 5: Generate AGENTS.md

Write AI instructions covering:

Workflow overview with pipeline diagram
Available skills grouped by stage
Skill usage guidelines (when to use each)
Recommended sequences for common tasks
Output standards
Quality gates between phases

Important: AGENTS.md is auto-loaded by Claude Code. Keep it concise (<500 lines) and focused on actionable instructions.

Use

assets/templates/AGENTS.template.md

as reference.

Step 6: Update project README

After creating a workflow in the ai-workflow project, update:

README.md (English):
- Add new workflow to the workflow table
- Add skills list under
```
<details>
```
  section
- Update skill count (e.g., "150+ skills")
README_cn.md (Chinese):
- Same updates in Chinese
- Link to
```
README_cn.md
```
  in workflow folder

Skill Sources

A. Skill Aggregators & Directories (for discovering skills)

Name	Type	Scale	Best For
Skillhub Awesome Skills	GitHub curated list	1000+ skills	Top skills by category, well-organized
Skillhub.club	Online directory	1000+	Web UI for browsing by category
SkillsMP	Marketplace	63,000+	Mass search with filters (category/popularity/author)
agent-skills.md	Online directory	Large	Install commands included ( `pnpm dlx add-skill ...` )
Claude Skills Hub	Online directory	Medium	Product-style browsing, good for inspiration
MCP Market Skills	Online store	Medium	Product pages with About/FAQ, content creator friendly
Skills Directory	Online directory	Medium	Copy SKILL.md directly, good structure
Smithery Skills	Skill directory	Medium	Includes expected_output.json, tool-oriented
Awesome Claude Skills (ComposioHQ)	GitHub awesome list	High stars	Ecosystem resources, comprehensive
Awesome Claude Skills (travisvn)	GitHub awesome list	5k+ stars	Second perspective, prevents single-source bias
Awesome Agent Skills	GitHub multi-agent list	1k+ stars	Covers Claude/Codex/Copilot/VSCode

B. Production-Ready Skill Repositories (for bulk import)

Repository	Focus	Best For
alirezarezvani/claude-skills	Multi-role skill packs	Content Creator suite (brand voice, SEO, platform frameworks)
gked2121/claude-skills	Production workflows	Clear workflow examples (Podcast→Content→Social→SEO)
sickn33/antigravity-awesome-skills	Skill registry	Organized by role ( `skills/content-creator` )
Microck/ordinary-claude-skills	600+ skills collection	skill-navigator, SEO clustering, email optimization
synapz-org/marketing-ops-hub	Marketing orchestration	Multi-skill coordination patterns
m2ai-portfolio/claude-skills	Creator/Growth suite	IG caption, YouTube script, tweet thread, blog outline
pluginagentmarketplace/custom-plugin-product-manager	Product Manager suite	user-research, roadmap, requirements, analytics
lyndonkl/claude	Decision frameworks	prioritization, forecasting, stakeholder mapping
jamesrochabrun/skills	Mixed professional	prd-generator, technical-launch-planner
britt/claude-code-skills	Writing & specs	writing-product-specs, writing-user-stories
troykelly/codex-skills	Workflow management	work-intake, milestone-management
escarti/agentDevPrompts	Feature lifecycle	feature-planning, feature-implementing
aj-geddes/useful-ai-prompts	Sprint & agile	agile-sprint-planning, requirements-gathering
daffy0208/ai-dev-standards	Multi-role standards	customer-feedback-analyzer, go-to-market-planner

C. Search Strategy

When the above sources lack needed skills:

GitHub Search:
```
"claude" "skills" "SKILL.md" <topic>
```
agent-skills.md Search: Browse by tags at https://agent-skills.md/tags
SkillsMP Search: Filter by category at https://skillsmp.com
Validate: Check SKILL.md has valid YAML frontmatter with
```
name
```
and
```
description
```

D. Download Commands

bash

# From GitHub repository
python scripts/download_skill.py https://github.com/<owner>/<repo> <skill-path> --output workflows/<workflow-name>/.claude/skills/

# Example: Download from alirezarezvani
python scripts/download_skill.py https://github.com/alirezarezvani/claude-skills skills/content-creator --output ./workflows/content-creator-workflow/.claude/skills/

# Example: Download from pluginagentmarketplace
python scripts/download_skill.py https://github.com/pluginagentmarketplace/custom-plugin-product-manager skills/user-research --output ./workflows/product-manager-workflow/.claude/skills/

Output Checklist

After workflow creation, verify:

```
.claude/skills/
```
contains downloaded skill folders
Each skill folder has
```
SKILL.md
```

All symlinks work (

.codex/skills

.cursor/skills

.opencode/skill

.agents/skills

.kilocode/skills

.roo/skills

.goose/skills

.gemini/skills

.agent/skills

.github/skills

skills

.factory/skills

.windsurf/skills

)

```
README.md
```
follows standard format with all sections
```
README_cn.md
```
created with Chinese translation
```
AGENTS.md
```
provides clear AI instructions (<500 lines)
```
settings.json
```
exists in
```
.claude/
```
Project README.md updated with new workflow
Project README_cn.md updated with new workflow
Skill counts updated in both README files

workflow-creator

NPX Install

Tags

SKILL.md Content

Workflow Creator

Workflow Creation Process

Step 1: Create directory structure

Step 2: Select and download skills

Step 3: Generate README.md (English)

Step 4: Generate README_cn.md (Chinese)

Step 5: Generate AGENTS.md

Step 6: Update project README

Skill Sources

A. Skill Aggregators & Directories (for discovering skills)

B. Production-Ready Skill Repositories (for bulk import)

C. Search Strategy

D. Download Commands

Output Checklist