GitHub - oyusypenko/creo: AI-powered design review, UX analysis, SEO audit, content generation, DevOps & testing toolkit for Claude Code. 12 skills, 12 parallel subagents. One-liner install.

AI-powered design, UX, content, DevOps, and testing toolkit for Claude Code.
13 specialized skills, 13 parallel subagents, and 3 optional extensions.

Why Creo?

Without Creo: You manually check responsive layouts, accessibility, SEO tags, write marketing copy, configure CI/CD, and set up tests -- each requiring different tools and expertise.

With Creo: One toolkit handles all of it. Run /creo design-review and get a full responsive + WCAG + heuristic audit. Run /creo seo for a complete SEO analysis. Run /creo marketing-site full to orchestrate an entire marketing site build with content, SEO, design review, localization, and QA -- all in parallel.

Zero dependencies -- pure markdown, one-liner install
13 skills run as parallel subagents for speed
Works with Claude Code, compatible with Codex, Cursor, and Gemini CLI

Features

Design Review -- Responsive testing (375-1920px), WCAG AA accessibility, Nielsen's 10 heuristics, visual polish
Design Implementation -- Execute fixes from review reports with verified code changes
UX Analysis -- Analyze your own app flows (internal) or competitor websites (external)
Marketing Content -- JTBD framework, customer pain points, i18n-ready JSON output
Image Prompts -- Generate optimized prompts for DALL-E 3, Midjourney, Stable Diffusion XL
SEO Audit -- Technical SEO, meta tags, structured data, sitemap, content optimization
DevOps -- GitHub, Cloudflare, Railway, Stripe CLI operations via specialized subagents
CI/CD Pipelines -- GitHub Actions workflow creation, debugging, optimization
Testing -- Unit (Vitest/Jest) and E2E (Playwright) test orchestration
Marketing Site -- 7-stage orchestrated site creation (content, SEO, design, localization, QA)
AI Generation -- LLM pipeline expertise (prompt engineering, validation, queues, SSE)

Quick Start

Install as a Claude Code plugin (recommended)

Inside Claude Code:

/plugin marketplace add oyusypenko/creo
/plugin install creo@creo

Or from the terminal:

claude plugin marketplace add oyusypenko/creo
claude plugin install creo@creo

All skills and subagents install together and stay updatable via /plugin marketplace update creo.

Install in Codex (OpenAI)

Codex supports the same Agent Skills format. Either install the skills directly:

npx skills add oyusypenko/creo

or add this repository as a Codex plugin marketplace (Codex reads .claude-plugin/marketplace.json):

codex plugin marketplace add oyusypenko/creo

Note: subagents (agents/*.md) are Claude Code-specific; Codex users get the skills only.

Install via script (Unix/macOS)

curl -fsSL https://raw.githubusercontent.com/oyusypenko/creo/main/install.sh | bash

Install via script (Windows)

irm https://raw.githubusercontent.com/oyusypenko/creo/main/install.ps1 | iex

Install via script (Git Clone)

git clone https://github.com/oyusypenko/creo.git
cd creo
./install.sh

Usage

claude                                          # Start Claude Code
/creo design-review http://localhost:3000       # Review a page
/creo content landing                           # Generate landing page copy
/creo seo init                                  # (SEO: run this FIRST on any Next.js project)
/creo seo audit https://example.com             # SEO audit (run after init)
/creo test unit                                 # Run unit tests
/creo marketing-site full                       # Build full marketing site

SEO: required first-run sequence

The creo-seo agent is Next.js-opinionated and works best when it has a cached project profile. Run these two commands in order on any new project:

/creo seo init — scans the codebase once and writes .claude/skills/creo-seo/creo-seo-{project_id}.md with the page inventory, detected stack (App Router vs Pages, i18n locales, SEO libraries), existing schema types, business-type hypothesis, and detected gaps. All subsequent SEO commands load this profile for context, skipping redundant scans.
/creo seo audit <url> — runs the full 7-phase audit end-to-end (technical SEO, content quality with AI-pattern detection, build validation, live Core Web Vitals, AI search / citability / llms.txt / 14-crawler access, schema deprecation sweep, composite scoring) and writes a markdown + JSON report to .claude/reports/seo/.

Re-run /creo seo init --refresh when you change router type, upgrade Next.js major version, add/remove locales, or modify next.config.* or package.json significantly.

For content-only deep dives (E-E-A-T, humanity score, citability rewrites, internal-linking audit), use /creo seo-content audit <url>.

Updating

Creo stamps the installed commit SHA to ~/.claude/skills/creo/.version and ships both an updater and a non-blocking update check.

Update to latest

Unix/macOS:

curl -fsSL https://raw.githubusercontent.com/oyusypenko/creo/main/update.sh | bash
# or, if already installed:
~/.claude/skills/creo/update.sh

Windows:

irm https://raw.githubusercontent.com/oyusypenko/creo/main/update.ps1 | iex

The updater runs uninstall.sh first so removed files are actually cleaned up, then reinstalls from main.

Auto-notify on Claude Code startup

Add a SessionStart hook in .claude/settings.json (project or user level) to check for updates when Claude Code starts. Silent on success, prints a one-line warning when an update is available. Never blocks or fails the session.

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "bash ~/.claude/skills/creo/update-check.sh"
      }]
    }]
  }
}

Windows:

{
  "hooks": {
    "SessionStart": [{
      "hooks": [{
        "type": "command",
        "command": "powershell -ExecutionPolicy Bypass -File %USERPROFILE%/.claude/skills/creo/update-check.ps1"
      }]
    }]
  }
}

The check fetches the latest commit on main from the GitHub API (3s timeout, falls back to git ls-remote) and compares against the installed .version. Offline and rate-limited cases exit silently.

Environment overrides (rarely needed):

CREO_REPO — repo slug (default: oyusypenko/creo)
CREO_SKILL_DIR — install location (default: ~/.claude/skills/creo)
CREO_TIMEOUT — curl timeout in seconds (default: 3)

Project Extensions

Teach any Creo skill about your project's domain, conventions, and file paths without modifying Creo itself. Extensions live inside your project repo at .claude/skills/creo-{skill}/creo-{skill}-{project_id}.md and are loaded automatically at the start of every skill run.

How it works:

Set project_id: "my-project" in .claude/project-config.md
Create .claude/skills/creo-{skill}/creo-{skill}-{project_id}.md for any skill you want to customize
Creo skills auto-load the matching extension before doing work

Example layout in your project:

.claude/
├── project-config.md                                     # project_id, URLs, locales, etc.
└── skills/
    ├── creo-design-review/
    │   └── creo-design-review-my-project.md              # Design tokens, component rules
    ├── creo-pipeline/
    │   └── creo-pipeline-my-project.md                   # CI/CD ports, services, deploy targets
    ├── creo-seo/
    │   └── creo-seo-my-project.md                        # Keyword strategy, sitemap paths
    ├── creo-ai-generation/
    │   └── creo-ai-generation-my-project.md              # Zod schemas, prompts, queue names
    └── creo-unit-test/
        └── creo-unit-test-my-project.md                  # Test utilities, factories, mocks

What extensions can contain:

Domain terminology and glossary (entity names, business concepts)
File path conventions specific to your monorepo
Tech stack specifics (Zod schemas, database tables, queue names)
Design tokens and component standards
CI/CD infrastructure (services, ports, secrets, deploy targets)
Test utilities, factories, mock patterns, page objects
Brand voice, tone, target audience, JTBD framing
Competitor lists and positioning notes

Why it matters:

Upstream Creo skills stay generic and reusable across any codebase. Your project-specific knowledge lives in your repo, survives Creo updates, and stays version-controlled alongside the code it describes. The same pattern works for all 13 skills plus DevOps subagents (GitHub/Cloudflare/Railway/Stripe CLI).

Compatibility

Creo skills use the standard SKILL.md format, making them compatible with:

Claude Code (primary, fully tested)
Codex CLI (OpenAI)
Cursor (via agent skills)
Gemini CLI (Google)

Commands

Command	Purpose
`/creo design-review <url>`	UI/UX review (responsive, WCAG AA, heuristics)
`/creo design-implement <report>`	Execute design fixes from review reports
`/creo ux-internal <flow>`	Analyze your own app's UX flows
`/creo ux-competitor <url>`	Analyze competitor websites
`/creo content <page-type>`	Generate marketing copy (JTBD, pain points)
`/creo image-prompt <context>`	Generate image prompts for AI models
`/creo seo <url>`	SEO audit & optimization
`/creo devops <command>`	Infrastructure (GitHub/Cloudflare/Railway/Stripe)
`/creo pipeline <command>`	CI/CD pipeline specialist (GitHub Actions)
`/creo test <command>`	Test orchestration (unit + E2E)
`/creo marketing-site <command>`	Full marketing site creation (7-stage)
`/creo ai-generation <command>`	AI generation pipeline expertise

Standalone Skills

Need just one skill? Each is available as a standalone install under creo-kit:

Skill	Repository	Install
SEO Audit	claude-seo-audit	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-seo-audit/main/install.sh \| bash`
Design Review	claude-design-review	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-design-review/main/install.sh \| bash`
Design Implement	claude-design-implement	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-design-implement/main/install.sh \| bash`
UX Audit	claude-ux-audit	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-ux-audit/main/install.sh \| bash`
Competitor Analysis	claude-competitor-analysis	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-competitor-analysis/main/install.sh \| bash`
Marketing Content	claude-marketing-content	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-marketing-content/main/install.sh \| bash`
Image Prompt	claude-image-prompt	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-image-prompt/main/install.sh \| bash`
DevOps Toolkit	claude-devops-toolkit	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-devops-toolkit/main/install.sh \| bash`
CI/CD Pipeline	claude-ci-pipeline	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-ci-pipeline/main/install.sh \| bash`
Test Orchestrator	claude-test-orchestrator	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-test-orchestrator/main/install.sh \| bash`
Marketing Site	claude-marketing-site	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-marketing-site/main/install.sh \| bash`
AI Generation	claude-ai-generation	`curl -fsSL https://raw.githubusercontent.com/creo-kit/claude-ai-generation/main/install.sh \| bash`

Install the full Creo toolkit to get all 13 skills at once, or pick individual ones above.

Optional Extensions

Extensions add tool-backed capabilities. Each is self-contained with its own install/uninstall.

Extension	What it adds	Requirements
image-generation	DALL-E 3 & ComfyUI image generation	Node.js 18+, OPENAI_API_KEY
i18n-translator	Batch JSON translation (39+ languages)	Python 3, LM Studio
gsc-analyzer	Google Search Console analysis (15+ analyzers)	Python 3, Google service account

Install an extension

# After cloning the repo:
./extensions/image-generation/install.sh
./extensions/i18n-translator/install.sh
./extensions/gsc-analyzer/install.sh

Extension commands become available after install:

/creo image-generation generate -- Generate marketing images
/creo i18n translate en uk,pl,de -- Batch translate locales
/creo gsc full-seo https://example.com -- Full GSC analysis

Architecture

creo/
├── creo/SKILL.md                  # Main orchestrator (entry point)
├── creo/references/               # 12 on-demand knowledge files
├── skills/                        # 13 sub-skills
├── agents/                        # 13 parallel subagents
├── extensions/                    # 3 optional extensions
│   ├── image-generation/          # Node.js (DALL-E 3, ComfyUI)
│   ├── i18n-translator/           # Python (LM Studio)
│   └── gsc-analyzer/              # Python (Google Search Console)
├── install.sh / install.ps1       # One-liner installers
└── uninstall.sh / uninstall.ps1   # Clean removal

Requirements

Claude Code CLI
Git (for installation)
Extensions have additional requirements (see extension READMEs)

Uninstall

curl -fsSL https://raw.githubusercontent.com/oyusypenko/creo/main/uninstall.sh | bash

Extensions must be uninstalled separately via their own uninstall scripts.

Documentation

Architecture -- System design overview
Commands -- Full command reference
Installation -- Detailed install guide

Contributing

See CONTRIBUTING.md for guidelines.

License

MIT

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Why Creo?

Features

Quick Start

Install as a Claude Code plugin (recommended)

Install in Codex (OpenAI)

Install via script (Unix/macOS)

Install via script (Windows)

Install via script (Git Clone)

Usage

SEO: required first-run sequence

Updating

Update to latest

Auto-notify on Claude Code startup

Project Extensions

Compatibility

Commands

Standalone Skills

Optional Extensions

Install an extension

Architecture

Requirements

Uninstall

Documentation

Contributing

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
Latest commit History 14 Commits
.claude-plugin		.claude-plugin
.github		.github
agents		agents
creo		creo
docs		docs
extensions		extensions
screenshots		screenshots
scripts		scripts
skills		skills
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
install.ps1		install.ps1
install.sh		install.sh
uninstall.ps1		uninstall.ps1
uninstall.sh		uninstall.sh
update-check.ps1		update-check.ps1
update-check.sh		update-check.sh
update.ps1		update.ps1
update.sh		update.sh

Folders and files

Latest commit

History

Repository files navigation

Why Creo?

Features

Quick Start

Install as a Claude Code plugin (recommended)

Install in Codex (OpenAI)

Install via script (Unix/macOS)

Install via script (Windows)

Install via script (Git Clone)

Usage

SEO: required first-run sequence

Updating

Update to latest

Auto-notify on Claude Code startup

Project Extensions

Compatibility

Commands

Standalone Skills

Optional Extensions

Install an extension

Architecture

Requirements

Uninstall

Documentation

Contributing

License

About

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages