suede-creator-skills

Install · The skills · Docs site · Skill catalog · Blog · MCP · @johnnysuede

By Jason Colapietro / Suede AI

Suede Creator Skills for SEO and business growth

Suede Creator Skills gives founders, marketers, and small teams reusable workflows for SEO audits, AI search visibility, conversion copy, and business operations. Run them in Claude Code or OpenAI Codex, with instructions you can inspect and adapt to your business.

Start with the business task:

• Search visibility: audit a page with suede-seo-audit, or plan content for AI search with suede-ai-seo.
• Positioning and conversion: define your audience and offer with suede-product-marketing, then write page copy with suede-copy.
• Business operations: map bottlenecks with suede-ops-assessment and define the system with suede-ops-architecture.

These are public, broadly reusable, open-source skill folders. Read each skills/<name>/SKILL.md before you install it. The pack also covers campaign planning, code review, app delivery, and creator-rights work. Original work is MIT licensed; adapted components carry their upstream notices beside the source. No binaries, no telemetry, no accounts.

Install in 30 seconds

Claude Code — add the marketplace, install the pack:

/plugin marketplace add JasonColapietro/suede-creator-skills
/plugin install suede-skills@suede

suede-skills installs every skill. Want less? Three focused subsets: /plugin install suede-marketing@suede (43 marketing and growth skills), /plugin install suede-agent-workflows@suede (Suede Thought Graph shipping, orchestration, workflows, evals), and /plugin install suede-code@suede (review, grade, ship-gate).

Codex — add the Codex-native marketplace, install the complete plugin:

codex plugin marketplace add JasonColapietro/suede-creator-skills --ref main
codex plugin add suede-skills@suede-codex

The Codex plugin loads every skill and registers 1 read-only MCP server with 9 tools. Restart Codex after installing or updating.

Hermes Agent (Nous Research) — this repo is a skills tap. Subscribe to browse and search the whole pack, or install one skill without subscribing:

hermes skills tap add JasonColapietro/suede-creator-skills
hermes skills search seo
hermes skills install JasonColapietro/suede-creator-skills/skills/suede-seo-audit

Hermes installs the whole skill folder — references/, agents/, evals/ — into ~/.hermes/skills/, security-scans it first, and shows it as /suede-seo-audit in chat. It carries the skills only: the MCP discovery server and the bundled Suede Thought Graph workflow are Claude Code and Codex surfaces.

Any agent (Cursor, Copilot, Windsurf, Claude Code, Codex) via the skills CLI:

npx skills add JasonColapietro/suede-creator-skills

Prefer a clone? install.sh copies every skill into ~/.claude/skills/ and prints the installed count:

git clone https://github.com/JasonColapietro/suede-creator-skills.git && bash suede-creator-skills/install.sh

You can also copy individual skill folders into .claude/skills/ (project) or ~/.claude/skills/ (user). One exception: the hardened suede-graph-flo-xr JavaScript workflow also requires the skill's bundled agents/suede-graph-flo-xr-*.md profiles in ~/.claude/agents and macOS sandbox-exec. The suede-skills and suede-agent-workflows Claude plugins, plus install.sh, install those profiles; a skill-folder-only or generic skills-CLI install does not. Codex can use the skill's orchestration contract, but does not execute this Claude Workflow runner. The caller passes the namespace explicitly on every launch: suede-skills for the full plugin, suede-agent-workflows for the focused plugin, and the empty string for clone or manual user-agent installs.

Codex — install one skill from GitHub:

python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  --repo JasonColapietro/suede-creator-skills \
  --path skills/suede-agent-teams

Swap skills/<skill> for any skill folder, or pass extra skills/<name> paths to install several at once. Restart Codex after installing.

Claude Code — project-level copy of a single skill:

git clone https://github.com/JasonColapietro/suede-creator-skills.git /tmp/suede-creator-skills
mkdir -p .claude/skills
cp -R /tmp/suede-creator-skills/skills/suede-agent-teams .claude/skills/

For a user-level install, copy into ~/.claude/skills/ instead. Claude.ai and organization-managed Claude Skills may use upload or admin-managed flows instead of filesystem copy. Review skill contents before enabling code execution.

MCP — dependency-free stdio server:

node mcp/suede-skills-mcp.mjs --profile all

Exposes 9 tools (list_suede_skills, list_suede_specialties, search_suede_skills, get_suede_skill, suede_install_options, suede_copy_seo_audit, suede_visibility_grade, suede_code_grade, suede_qa_checklist), 7 resources, and 5 prompts over JSON-RPC.

Try it right now

Install the pack, then give your agent a page to audit:

Use suede-seo-audit to audit this page for search visibility and return prioritized findings with exact copy fixes: [your page URL]

For a nontrivial multi-file change, run the ship DAG:

Use suede-graph-flo-xr to take this change through the canonical Suede DAG: research it, build it in disjoint lanes, refute the review findings, and hand back evidence.

If the pack saves you an hour, star the repo — stars are how other builders find it.

Orchestration: broad outcomes, adversarial review

Tell your agent "max effort, spare no compute, fix everything" and most of the time you get enthusiasm, not engineering. The orchestration lane turns that intent into structure:

• suede-graph-flo-xr runs a Suede Thought Graph shipping search on a repo: generate competing plans, score and prune them, adversarially refute and improve survivors, aggregate compatible lanes, then build, review, and gate only the selected plan. Light/standard/deep are capped at 55/110/200 calls. Production reads only; it never deploys.
• suede-agent-teams wires complex changes into coordinated agent lanes with WIP collision detection, RFC mode, feature-flag strategy, rollback trees, and a handoff checklist that won't close without evidence. Its public-contribution mode adds scored issue queues, atomic leases, isolated worktrees, and authority-gated contribution packets.
• suede-ship-copy is a separate copy-only orchestration DAG for one high-stakes piece of writing: five blind research lenses, a claim audit that closes the set of assertable facts, disjoint section writers, adversarial refutation, a deslop pass, and a publish-readiness gate.

The A–F ship grade

suede-code runs a findings pass (TypeScript, React, Next.js, OWASP, and database checklists), then returns a grade card scoring seven lanes: Correctness, Security and permissions, Data and state, Domain truth, UX and release behavior, Tests and verification, and Deploy readiness. The weakest lane caps the grade, and auth and payment surfaces carry grade caps of their own.

If it hits an instant-F trigger — a hardcoded secret, a permission check bypassable via a request param — the grade locks to F with the exact file and line, and no other lane can raise it. A polite review tells you what could be better. A grade tells you whether to ship.

The skills

Every link below goes to the skill's folder in this repo; the skill catalog has the same list with install commands per skill.

Agent orchestration & wor