Skip to content
Back to search

suede

Open-source AI skills for SEO, marketing, and business operations in Claude Code and Codex.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 12 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/JasonColapietro/suede-creator-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/JasonColapietro/suede-creator-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jasoncolapietro--suede-creator-skills/badge.svg)](/listings/jasoncolapietro--suede-creator-skills)

HTML

<a href="/listings/jasoncolapietro--suede-creator-skills"><img src="/api/listings/jasoncolapietro--suede-creator-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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` (41 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 12 tools. Restart Codex after installing or updating.

**Hermes Agent** ([Nous Research](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)) — 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](https://github.com/vercel-labs/skills):

npx skills add JasonColapietro/suede-creator-skills

**Python ([PyPI](https://pypi.org/project/suede-creator-skills/)):** install the package, then load the pack into your agent. `--target codex` installs into Codex, and existing folders are kept unless you pass `--force`:

pipx install suede-creator-skills && suede-skills install

**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.

<details> <summary><b>More install routes</b> (single-skill Codex installer, project-level copy, MCP)</summary>

<br>

**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.

**MCP — dependency-free stdio server:**

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 96 lines
  1. {
  2. "name": "suede",
  3. "description": "Open-source AI skills for SEO, marketing, and business operations in Claude Code and Codex.",
  4. "owner": {
  5. "name": "Jason Colapietro",
  6. "url": "https://github.com/JasonColapietro"
  7. },
  8. "plugins": [
  9. {
  10. "name": "suede-skills",
  11. "source": "./",
  12. "strict": true,
  13. "description": "Open-source AI skills for SEO, marketing, and business operations in Claude Code and Codex. Installs the complete pack, including code review, app delivery, and creator workflows."
  14. },
  15. {
  16. "name": "suede-agent-workflows",
  17. "source": "./skills",
  18. "strict": false,
  19. "skills": [
  20. "./suede-graph-flo-xr",
  21. "./suede-ship-copy",
  22. "./suede-agent-teams",
  23. "./suede-workflow-skills",
  24. "./suede-ai-eval"
  25. ],
  26. "agents": [
  27. "./suede-graph-flo-xr/agents/suede-graph-flo-xr-scout.md",
  28. "./suede-graph-flo-xr/agents/suede-graph-flo-xr-code-reader.md",
  29. "./suede-graph-flo-xr/agents/suede-graph-flo-xr-web-reader.md",
  30. "./suede-graph-flo-xr/agents/suede-graph-flo-xr-patch-author.md",
  31. "./suede-graph-flo-xr/agents/suede-graph-flo-xr-applier.md",
  32. "./suede-graph-flo-xr/agents/suede-graph-flo-xr-verifier.md"
  33. ],
  34. "description": "Multi-agent orchestration subset: search competing plans and ship one selected repo change through the Suede Thought Graph DAG (suede-graph-flo-xr), coordinate build lanes with quality gates and a signed handoff (suede-agent-teams), route cross-surface work end to end (suede-workflow-skills), and turn AI features into eval specs and acceptance gates (suede-ai-eval)."
  35. },
  36. {
  37. "name": "suede-code",
  38. "source": "./skills",
  39. "strict": false,
  40. "skills": [
  41. "./suede-code",
  42. "./suede-ci-gate"
  43. ],
  44. "description": "Code quality subset: one-pass review and A-F ship verdict with TypeScript, React, Next.js, OWASP, and database checklists, plus findings-only and grade-only modes (suede-code), and CI branch protection that gates the merge (suede-ci-gate)."
  45. },
  46. {
  47. "name": "suede-marketing",
  48. "source": "./skills",
  49. "strict": false,
  50. "skills": [
  51. "./suede-ab-testing",
  52. "./suede-ad-creative",
  53. "./suede-ads",
  54. "./suede-ai-seo",
  55. "./suede-analytics",
  56. "./suede-aso",
  57. "./suede-attribution",
  58. "./suede-churn-prevention",
  59. "./suede-co-marketing",
  60. "./suede-cold-email",
  61. "./suede-community-marketing",
  62. "./suede-competitor-profiling",
  63. "./suede-competitors",
  64. "./suede-clip-to-guide",
  65. "./suede-content-strategy",
  66. "./suede-customer-research",
  67. "./suede-directory-submissions",
  68. "./suede-emails",
  69. "./suede-free-tools",
  70. "./suede-image",
  71. "./suede-influencer-outreach",
  72. "./suede-lead-magnets",
  73. "./suede-marketing-council",
  74. "./suede-marketing-loops",
  75. "./suede-marketing-plan",
  76. "./suede-newsroom",
  77. "./suede-offers",
  78. "./suede-onboarding",
  79. "./suede-paywalls",
  80. "./suede-pricing",
  81. "./suede-product-marketing",
  82. "./suede-programmatic-seo",
  83. "./suede-prospecting",
  84. "./suede-public-relations",
  85. "./suede-referrals",
  86. "./suede-reverse-engineer-anyone",
  87. "./suede-revops",
  88. "./suede-sales-enablement",
  89. "./suede-sms",
  90. "./suede-social",
  91. "./suede-video"
  92. ],
  93. "description": "Suede AI marketing and growth subset: SEO and AI search, paid acquisition and outbound, monetization (pricing, offers, paywalls), lifecycle and retention, and the measurement and operations layer. License notices for adapted material are in NOTICE.md."
  94. }
  95. ]
  96. }
README.md · README · 363 lines
  1. <div align="center">
  2. <img src="docs/assets/readme/hero.svg" alt="Suede AI Skills — the ship discipline your agent is missing. Open-source skills for Claude Code and Codex." width="100%">
  3. <br><br>
  4. [![Skills: 67](https://img.shields.io/badge/skills-67-c8a96e?labelColor=080808)](#the-skills)
  5. [![Licenses: MIT + BSD](https://img.shields.io/badge/licenses-MIT_%2B_BSD-c8a96e?labelColor=080808)](NOTICE.md)
  6. [![Claude Code](https://img.shields.io/badge/Claude_Code-plugin-c8a96e?labelColor=080808)](#install-in-30-seconds)
  7. [![Codex](https://img.shields.io/badge/Codex-plugin-c8a96e?labelColor=080808)](#install-in-30-seconds)
  8. [![PyPI](https://img.shields.io/pypi/v/suede-creator-skills?color=c8a96e&labelColor=080808)](https://pypi.org/project/suede-creator-skills/)
  9. [![MCP](https://img.shields.io/badge/MCP-stdio_server-c8a96e?labelColor=080808)](#mcp-server)
  10. [![Skills Directory: Grade A](https://www.skillsdirectory.com/api/skills/jasoncolapietro-suede-design/badge)](https://www.skillsdirectory.com/skills/jasoncolapietro-suede-design)
  11. [![seoskills.sh: Suede AI SEO listed](https://img.shields.io/badge/seoskills.sh-Suede_AI_SEO_listed-c8a96e?labelColor=080808)](https://seoskills.sh/jasoncolapietro/suede-creator-skills/suede-ai-seo)
  12. [![Hysen Labs](https://hysenlabs.com/badge/jasoncolapietro-suede-creator-skills.svg)](https://hysenlabs.com/projects/jasoncolapietro-suede-creator-skills)
  13. [![suede-skills-mcp MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/JasonColapietro/suede-creator-skills/badges/score.svg)](https://glama.ai/mcp/servers/JasonColapietro/suede-creator-skills)
  14. [![GitHub stars](https://img.shields.io/github/stars/JasonColapietro/suede-creator-skills?style=social)](https://github.com/JasonColapietro/suede-creator-skills/stargazers)
  15. <a href="https://trendshift.io/repositories/82031?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-82031" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/82031/daily?language=Python" alt="JasonColapietro%2Fsuede-creator-skills | Trendshift" width="250" height="55"/></a>
  16. **[Install](#install-in-30-seconds)** · **[The skills](#the-skills)** · **[Docs site](https://skills.suedeai.ai/)** · **[Skill catalog](https://skills.suedeai.ai/skills/)** · **[Blog](https://skills.suedeai.ai/blog/)** · **[MCP](#mcp-server)** · **[@johnnysuede](https://x.com/johnnysuede)**
  17. <sub>By <a href="https://suedeai.ai/founder">Jason Colapietro</a> / <a href="https://suedeai.ai">Suede AI</a></sub>
  18. </div>
  19. ---
  20. ## Suede Awesome Everything
  21. **AI agent skills, scored 0–99.**
  22. **[Compare skills by their 0–99 quality scores](awesome/README.md)**: verified numeric scores from [Suede’s published structural rubric](https://skills.suedeai.ai/directory/methodology/), with source links and browsing by category and publisher. Published scores retain the current 99-point cap; quality scores do not certify security.
  23. [Compare scores](awesome/README.md#compare-099-quality-scores) · [Categories](awesome/README.md#contents) · [Publishers](awesome/publishers.md) · [Featured projects](awesome/featured.md) · [Contribute a listing](awesome/CONTRIBUTING.md)
  24. ## Recognition and discovery
  25. [![The Manifest: Suede AI SEO #25 for Florida AI deployment, October 30, 2026](https://img.shields.io/badge/The_Manifest-%2325_Florida_AI_deployment-c8a96e?labelColor=080808)](https://themanifest.com/artificial-intelligence/consulting/deployment/companies/florida)
  26. [![Gigawatt Group: Suede AI vs. Profound](https://img.shields.io/badge/Gigawatt_Group-Suede_AI_vs_Profound-c8a96e?labelColor=080808)](https://gigawattgroup.com/generative-engine-optimization/suede-ai-vs-profound-trade-associations/)
  27. Suede AI SEO, the company’s AI search visibility practice, is **#1 among Palm Beach County-based companies listed in The Manifest’s Florida AI Deployment directory, and #25 statewide**, as of October 30, 2026. The county position is derived from the directory’s listed company locations. [View the ranking](https://themanifest.com/artificial-intelligence/consulting/deployment/companies/florida). Gigawatt Group also [compares Suede AI’s managed GEO practice with Profound](https://gigawattgroup.com/generative-engine-optimization/suede-ai-vs-profound-trade-associations/).
  28. The SEO skill is [listed on seoskills.sh](https://seoskills.sh/jasoncolapietro/suede-creator-skills/suede-ai-seo), updated October 24, 2026. The project’s Hysen Labs, Skills Directory and Trendshift badges link directly to their reports above.
  29. ## Suede AI Skills for SEO and business growth
  30. Suede AI 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.
  31. **Start with the business task:**
  32. - **Search visibility:** audit a page with `suede-seo-audit`, or plan content for AI search with `suede-ai-seo`.
  33. - **Positioning and conversion:** define your audience and offer with `suede-product-marketing`, then write page copy with `suede-copy`.
  34. - **Business operations:** map bottlenecks with `suede-ops-assessment` and define the system with `suede-ops-architecture`.
  35. These are **public, broadly reusable, open-source skill folders**, installable from one path. Every `skills/<name>/SKILL.md` is readable on GitHub. The pack also covers campaign planning, code review, app delivery, and music release prep. Original work is MIT licensed; adapted components keep their upstream licenses, listed in [NOTICE.md](NOTICE.md). No binaries, no telemetry, no accounts.
  36. <img src="docs/assets/readme/pack-map.svg" alt="The pack at a glance: 38 marketing and growth skills, 7 design copy and SEO, 7 orchestration and workflows, 4 code quality and shipping, 4 creator rights and release, 3 mobile apps." width="100%">
  37. ## Install in 30 seconds
  38. **Claude Code** — add the marketplace, install the pack:
  39. ```text
  40. /plugin marketplace add JasonColapietro/suede-creator-skills
  41. /plugin install suede-skills@suede
  42. ```
  43. `suede-skills` installs every skill. Want less? Three focused subsets: `/plugin install suede-marketing@suede` (41 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).
  44. **Codex** — add the Codex-native marketplace, install the complete plugin:
  45. ```bash
  46. codex plugin marketplace add JasonColapietro/suede-creator-skills --ref main
  47. codex plugin add suede-skills@suede-codex
  48. ```
  49. The Codex plugin loads every skill and registers 1 read-only MCP server with 12 tools. Restart Codex after installing or updating.
  50. **Hermes Agent** ([Nous Research](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills)) — this repo is a skills tap. Subscribe to browse and search the whole pack, or install one skill without subscribing:
  51. ```bash
  52. hermes skills tap add JasonColapietro/suede-creator-skills
  53. hermes skills search seo
  54. hermes skills install JasonColapietro/suede-creator-skills/skills/suede-seo-audit
  55. ```
  56. 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.
  57. **Any agent** (Cursor, Copilot, Windsurf, Claude Code, Codex) via the [skills CLI](https://github.com/vercel-labs/skills):
  58. ```bash
  59. npx skills add JasonColapietro/suede-creator-skills
  60. ```
  61. **Python ([PyPI](https://pypi.org/project/suede-creator-skills/)):** install the package, then load the pack into your agent. `--target codex` installs into Codex, and existing folders are kept unless you pass `--force`:
  62. ```bash
  63. pipx install suede-creator-skills && suede-skills install
  64. ```
  65. **Prefer a clone?** `install.sh` copies every skill into `~/.claude/skills/` and prints the installed count:
  66. ```bash
  67. git clone https://github.com/JasonColapietro/suede-creator-skills.git && bash suede-creator-skills/install.sh
  68. ```
  69. You can also copy individual skill folders into `.claude/skills/` (project) or
  70. `~/.claude/skills/` (user). One exception: the hardened `suede-graph-flo-xr` JavaScript
  71. workflow also requires the skill's bundled `agents/suede-graph-flo-xr-*.md` profiles in
  72. `~/.claude/agents` and macOS `sandbox-exec`. The `suede-skills` and
  73. `suede-agent-workflows` Claude plugins, plus `install.sh`, install those profiles;
  74. a skill-folder-only or generic skills-CLI install does
  75. not. Codex can use the skill's orchestration contract, but does not execute this
  76. Claude Workflow runner. The caller passes the namespace explicitly on every
  77. launch: `suede-skills` for the full plugin, `suede-agent-workflows` for the
  78. focused plugin, and the empty string for clone or manual user-agent installs.
  79. <details>
  80. <summary><b>More install routes</b> (single-skill Codex installer, project-level copy, MCP)</summary>
  81. <br>
  82. **Codex — install one skill from GitHub:**
  83. ```bash
  84. python3 ~/.codex/skills/.system/skill-installer/scripts/install-skill-from-github.py \
  85. --repo JasonColapietro/suede-creator-skills \
  86. --path skills/suede-agent-teams
  87. ```
  88. Swap `skills/<skill>` for any skill folder, or pass extra `skills/<name>` paths to install several at once. Restart Codex after installing.
  89. **Claude Code — project-level copy of a single skill:**
  90. ```bash
  91. git clone https://github.com/JasonColapietro/suede-creator-skills.git /tmp/suede-creator-skills
  92. mkdir -p .claude/skills
  93. cp -R /tmp/suede-creator-skills/skills/suede-agent-teams .claude/skills/
  94. ```
  95. 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.
  96. **MCP — dependency-free stdio server:**
  97. ```bash
  98. node mcp/suede-skills-mcp.mjs --profile all
  99. ```
  100. Exposes 12 tools (`list_suede_skills`, `list_suede_specialties`, `search_suede_skills`, `get_suede_skill`, `plan_suede_workflow`, `suede_live_page_audit`, `suede_copy_check`, `suede_install_options`, `suede_copy_seo_audit`, `suede_visibility_grade`, `suede_code_grade`, `suede_qa_checklist`), 7 resources, a `suede://skill/{name}` template, and 5 prompts over JSON-RPC. `suede_live_page_audit` grades any public URL A-F for Google and AI search from the HTML it serves. Run it in Docker with `docker build -t suede-skills-mcp . && docker run -i --rm suede-skills-mcp`.
  101. </details>
  102. ## Find it on
  103. <!-- listings:start -->
  104. Listed on [skills.sh](https://www.skills.sh/jasoncolapietro/suede-creator-skills) · [SkillsMP](https://skillsmp.com/creators/jasoncolapietro/suede-creator-skills) · [SkillsLLM](https://skillsllm.com/skill/suede-creator-skills) · [HOL Plugin Registry](https://hol.org/registry/plugins/suede-ai%2Fsuede-skills) · [Skills Directory](https://www.skillsdirectory.com/authors/jasoncolapietro) · [ClaudSkills](https://claudskills.com/author/jasoncolapietro/) · [PyPI](https://pypi.org/project/suede-creator-skills/) · [Official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.JasonColapietro%2Fsuede-skills-mcp/versions/latest) · [npm](https://www.npmjs.com/package/suede-skills-mcp) · [Glama](https://glama.ai/mcp/servers/JasonColapietro/suede-creator-skills) · [MCP Market](https://mcpmarket.com/server/suede-creator-skills) · [Awesome Claude Skills (awesomeclaude.ai)](https://awesomeclaude.ai/awesome-claude-skills) · [VoltAgent/awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) · [Trendshift](https://trendshift.io/repositories/82031).
  105. All 34 directories, registries and curated lists: [skills.suedeai.ai/listings.html](https://skills.suedeai.ai/listings.html)
  106. <!-- listings:end -->
  107. ## Try it right now
  108. Install the pack, then give your agent a page to audit:
  109. ```text
  110. Use suede-seo-audit to audit this page for search visibility and return prioritized findings with exact copy fixes: [your page URL]
  111. ```
  112. For a nontrivial multi-file change, run the ship DAG:
  113. ```text
  114. 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.
  115. ```
  116. If the pack saves you an hour, [star the repo](https://github.com/JasonColapietro/suede-creator-skills/stargazers) — stars are how other builders find it.
  117. ## Orchestration: broad outcomes, adversarial review
  118. 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:
  119. - [`suede-graph-flo-xr`](skills/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.
  120. - [`suede-agent-teams`](skills/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.
  121. - [`suede-ship-copy`](skills/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.
  122. ## The A–F ship grade
  123. [`suede-code`](skills/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.
  124. <img src="docs/assets/readme/ship-grade.svg" alt="The ship grade: seven graded lanes and one verdict. Instant-F triggers such as a hardcoded secret lock the grade to F with the exact file and line." width="100%">
  125. 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.
  126. ## The skills
  127. Every link below goes to the skill's folder in this repo; the [skill catalog](https://skills.suedeai.ai/skills/) has the same list with install commands per skill.
  128. ### Agent orchestration & workflows
  129. | Skill | What it does |
  130. |---|---|
  131. | [`suede-agent-teams`](skills/suede-agent-teams) | Coordinate agent lanes and public contribution programs with collision checks, atomic issue leases, review gates, and a signed handoff |
  132. | [`suede-graph-flo-xr`](skills/suede-graph-flo-xr) | Suede Thought Graph repo shipping: search competing plans, score and prune, refute and improve, aggregate compatible lanes, then mutate only the selected plan; 55/110/200-call caps; production reads only, never deploys |
  133. | [`suede-ship-copy`](skills/suede-ship-copy) | Copy-only orchestration DAG for one high-stakes piece: blind research, claim audit, section writers, refutation, publish gate |
  134. | [`suede-ai-eval`](skills/suede-ai-eval) | AI-SPEC artifacts, failure-mode rubrics, eval cases, and acceptance gates for LLM, RAG, classifier, and agent surfaces |
  135. | [`suede-workflow-skills`](skills/suede-workflow-skills) | Umbrella router that loads the full pack, picks the specialist, and hands back one scored next move as a runnable prompt |
  136. | [`suede-ops-assessment`](skills/suede-ops-assessment) | Map how work actually happens before anyone designs a system: interviews with the people doing it, a silo inventory, friction measured in the operation's own numbers |
  137. | [`suede-ops-architecture`](skills/suede-ops-architecture) | Fix the shape of a system before anyone builds it: entity schema, one write path per entity, each unit of work routed to an automation, an agent, or a human |
  138. ### Code quality & shipping
  139. | Skill | What it does |
  140. |---|---|
  141. | [`suede-code`](skills/suede-code) | Review + A–F grade in one pass, 7 lanes, instant-F triggers; findings-only and grade-only modes |
  142. | [`suede-ci-gate`](skills/suede-ci-gate) | Write CI that gates the merge — stack/lockfile detection, one required check, branch protection |
  143. | [`suede-parity-contract`](skills/suede-parity-contract) | Hold one domain consistent across web, iOS, Android, and docs with a contract generated from the reference surface |
  144. | [`suede-clip-to-guide`](skills/suede-clip-to-guide) | Turn a clip, talk moment, or transcript into a clip-to-guide funnel package with rights routing and an evidence gate |
  145. ### Design, copy & SEO
  146. | Skill | What it does |
  147. |---|---|
  148. | [`suede-seo-audit`](skills/suede-seo-audit) | SEO/AEO/GEO, metadata, schema, internal-link, and intent audit |
  149. | [`suede-design`](skills/suede-design) | Read-only whole-flow and UI diff reviews, plus authorized builds with existing brand, tokens, hierarchy, accessibility and rendered visual QA |
  150. | [`suede-component-lab`](skills/suede-component-lab) | Dev-only workbenches importing real components with synthetic states, stress fixtures and live variants |
  151. | [`suede-interface-explain`](skills/suede-interface-explain) | Read-only explanations of interface mechanisms, traced to source locations and observed behavior |
  152. | [`suede-copy`](skills/suede-copy) | Full writing lane: conversion and SEO copy, headline formulas, persuasion frameworks, A/B variants, anti-slop gate, copy score |
  153. | [`suede-deslop`](skills/suede-deslop) | Context-aware anti-slop cleanup or findings-only audit that preserves facts, voice, house style, and intentional phrasing, with a 50-point score gate |
  154. | [`suede-visibility-grader`](skills/suede-visibility-grader) | A–F page grades for findability, clarity, CTA pull, proof, and AI citation readiness |
  155. | [`suede-site-alchemy`](skills/suede-site-alchemy) | Funnel analysis, friction audit, conversion math, ranked quick-wins |
  156. | [`suede-launch-packaging`](skills/suede-launch-packaging) | Package work as a launch: docs, install commands, proof links, QA |
  157. ### Mobile apps
  158. | Skill | What it does |
  159. |---|---|
  160. | [`site-to-ios-app`](skills/site-to-ios-app) | Convert any website into an App Store-ready iOS app: audit, 4.2 wrapper-risk gate, shell strategy, release gate |
  161. | [`android-app-factory`](skills/android-app-factory) | One prompt to a Play Store-ready native Android app: Kotlin + Jetpack Compose scaffold, Play Billing, ASO listing, signed release |
  162. | [`suede-play-release`](skills/suede-play-release) | Ship an Android release through the Play Developer API: credential preflight, AAB checks, staged rollout, and a track readback |
  163. ### Creator rights & release
  164. Rights and release-prep tooling for working musicians and creators — see the [skill catalog](https://skills.suedeai.ai/skills/) for each one: [`suede-campaign-in-a-box`](skills/suede-campaign-in-a-box), [`suede-sync-packaging`](skills/suede-sync-packaging), [`suede-release-linter`](skills/suede-release-linter), [`suede-rights-passport`](skills/suede-rights-passport) (rights gap audit, then the transfer package).
  165. ### Marketing & growth
  166. Thirty-nine skills covering paid acquisition and outbound, monetization, lifecycle and
  167. retention, and the measurement and operations layer — `suede-ads`, `suede-ad-creative`,
  168. `suede-cold-email`, `suede-influencer-outreach`, `suede-prospecting`, `suede-public-relations`, `suede-directory-submissions`,
  169. `suede-pricing`, `suede-offers`, `suede-paywalls`, `suede-onboarding`,
  170. `suede-churn-prevention`, `suede-emails`, `suede-referrals`, `suede-co-marketing`,
  171. `suede-community-marketing`, `suede-lead-magnets`, `suede-free-tools`, `suede-sms`,
  172. `suede-marketing-loops`, `suede-analytics`, `suede-ab-testing`, `suede-revops`,
  173. `suede-sales-enablement`, `suede-programmatic-seo`, `suede-content-strategy`,
  174. `suede-marketing-plan`, `suede-marketing-council`, `suede-social`,
  175. `suede-aso`, `suede-video`, `suede-image`, `suede-product-marketing`, `suede-competitors`,
  176. `suede-competitor-profiling`, `suede-reverse-engineer-anyone`, `suede-customer-research`,
  177. `suede-ai-seo`, `suede-attribution`.
  178. The content-production lane adds one more workflow:
  179. | Skill | What it does |
  180. |---|---|
  181. | [`suede-newsroom`](skills/suede-newsroom) | Runs one idea through a six-role content pipeline — written role contracts, an inspectable campaign record, seven distribution entryways so no two assets argue the same thing, and a keep/test/stop review |
  182. ## From the blog
  183. Essays on why the pack is built the way it is:
  184. - [**Two skills, and the bugs that wrote them**](https://skills.suedeai.ai/blog/two-skills-and-the-bugs-that-wrote-them.html) — Google Play publishing from the terminal, and a parity contract that keeps four surfaces of one product honest
  185. - [**71 skills installed. Your agent reads almost none of them.**](https://skills.suedeai.ai/blog/progressive-disclosure-ship-dag-and-mcp.html) — progressive disclosure, Suede Thought Graph shipping search, and the MCP layer
  186. - [**Why breadth is free now, and what that changes**](https://skills.suedeai.ai/blog/why-breadth-is-free.html) — the economics of broad skill packs
  187. - [**NOT FOR: the two words that make a big skill pack work**](https://skills.suedeai.ai/blog/not-for-the-line-that-makes-a-pack-work.html) — how skills route without colliding
  188. - [**Your memory file is a tax you pay on every prompt**](https://skills.suedeai.ai/blog/memory-belongs-in-skills.html) — why memory belongs in skills
  189. - [**Two new lanes: a next-action recommender and a one-prompt Android app factory**](https://skills.suedeai.ai/blog/android-recommend-next-action-and-workflows.html)
  190. ## Public pages
  191. - [GitHub repository](https://github.com/JasonColapietro/suede-creator-skills)
  192. - [GitHub Pages site](https://skills.suedeai.ai/) — public documentation generated from this repo
  193. - [Skill docs catalog](https://skills.suedeai.ai/skills/) — every skill with install and resource links
  194. - [Agent Skills Directory](https://skills.suedeai.ai/directory/) ([data](directory/)) — other authors' public skills in sixteen category directories, each scored 0–99 by the published, graded [Suede Skill Check](https://skills.suedeai.ai/directory/methodology/) and linked to its source; listings scoring 80–99 offer separate numeric and A/B README shields, both linking to their listing. Authors can [request a listing, score help or badge verification](https://skills.suedeai.ai/directory/submit/); displaying either valid linked badge (or both) can qualify for a limited-time feature placement after verification. Security scan status is separate from the structural score
  195. - [Installs and MCP page](https://skills.suedeai.ai/plugins.html) — install commands plus the Suede AI Skills MCP
  196. - [Copy bank](https://skills.suedeai.ai/copy.html) ([source](COPY.md)) and [public explainer pack](PROMO.md)
  197. - [S-Tier: the builder's book](https://skills.suedeai.ai/book/) ([source](book/), [PDF](https://skills.suedeai.ai/book/s-tier.pdf)) — a free, roughly 29,900-word book on how Agent Skills work and how to get genuinely good with them
  198. ## MCP server
  199. The repo ships a dependency-free stdio MCP server at [`mcp/`](mcp/). It implements `initialize`, `tools/list`, `tools/call`, `resources/list`, `resources/read`, `prompts/list`, and `prompts/get`.
  200. ```bash
  201. node mcp/suede-skills-mcp.mjs --profile all
  202. ```
  203. | Tools (9) | Resources (7) | Prompts (5) |
  204. |---|---|---|
  205. | `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` | catalog, specialties, plugins, copy-seo-audit, visibility-grade, code-grade, qa-checklist | discovery and audit prompts |
  206. ## Safety
  207. Core local workflows inspect current files, pages, repos, and local folders
  208. without uploading by default or granting new authority. Explicit browser,
  209. deployment, marketplace, publishing, or support workflows use the operator's
  210. existing authenticated access, and only when that action is authorized. The
  211. skills never request secrets.
  212. The creator skills generate private drafts by default: reports and packages can contain names, payment notes, file names, hashes, rights claims, and provenance notes. Review and redact before publishing or sending outside the intended workflow.
  213. CLI flags on the creator scripts: `--include-hidden`, `--include-other`, `--include-absolute-paths`, and `--force`. Scripts skip hidden files, secret-like files, dependency folders, and build outputs by default, and refuse to write a package into or under its source folder.
  214. Every skill ships with a [skill card](SKILL-CARDS.md) — a release record following the [NVIDIA skill-card template](https://docs.nvidia.com/skills/skill-cards) that states the skill's purpose, owner, license, dependencies, known risks and mitigations, output, and release evidence, so a reviewer can evaluate it without opening the source first.
  215. ## Status
  216. The creator scripts are dependency-light Python and run on the standard library. Optional enhancements use installed packages when available — Pillow for artwork dimension checks, PyYAML for YAML metadata:
  217. ```bash
  218. python3 -m pip install PyYAML
  219. ```
  220. ## Frequently asked questions
  221. ### What is Suede AI Skills?
  222. Suede AI Skills is an open-source pack of agent skills for Claude Code and OpenAI Codex. Each skill is a folder with a `SKILL.md` that teaches the agent a repeatable workflow: SEO audits, AI search visibility, conversion copy, code review, ship gates and app delivery.
  223. ### Who created Suede AI Skills?
  224. Jason Colapietro, founder and CEO of Suede AI, created Suede AI Skills and maintains it at [github.com/JasonColapietro/suede-creator-skills](https://github.com/JasonColapietro/suede-creator-skills).
  225. ### How do I install Suede AI Skills in Claude Code?
  226. Run `/plugin marketplace add JasonColapietro/suede-creator-skills`, then `/plugin install suede-skills@suede`. See [Install in 30 seconds](#install-in-30-seconds) for the focused subsets.
  227. ### How do I install Suede AI Skills in Codex?
  228. Run `codex plugin marketplace add JasonColapietro/suede-creator-skills --ref main`, then `codex plugin add suede-skills@suede-codex`, and restart Codex.
  229. ### Is Suede AI Skills free?
  230. Yes. Original work is MIT licensed, and adapted components keep their upstream licenses, listed in [NOTICE.md](NOTICE.md). The pack has no binaries, no telemetry and no accounts.
  231. ### Does Suede AI Skills include an MCP server?
  232. Yes. A dependency-free stdio MCP server ships in [`mcp/`](mcp/) and is published to npm as [`suede-skills-mcp`](https://www.npmjs.com/package/suede-skills-mcp) and listed in the [Official MCP Registry](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.JasonColapietro%2Fsuede-skills-mcp/versions/latest) and on [Glama](https://glama.ai/mcp/servers/JasonColapietro/suede-creator-skills).
  233. ### Which skills help with SEO, AEO and GEO?
  234. Start with `suede-seo-audit` to audit a page for search visibility, and `suede-ai-seo` to plan content for AI search and answer engines. The [skill catalog](https://skills.suedeai.ai/skills/) lists the rest.
  235. ## About the creator
  236. **Jason Colapietro** created and maintains Suede AI Skills. He is an engineer, author, and the founder and CEO of [Suede AI](https://suedeai.ai), an agentic platform company in West Palm Beach, Florida, and wrote The Claude Code Bible and Codex in Production, operator's guides to the two coding agents this pack runs in. He spent years watching hired marketing firms skip the fundamentals on his own products; this pack turns those misses into reusable, inspectable agent workflows instead of one-off fixes. Suede AI is a member of [Claude for Startups](https://claude.com/programs/startups), Anthropic's startup program.
  237. Jason Colapietro’s training includes Claude Academy / Anthropic badges in the Claude API, Claude Code, Model Context Protocol (MCP), Claude with Amazon Bedrock and Claude on Google Cloud. His search training includes HubSpot Academy’s AEO Fundamentals and Semrush Academy certificates in AI search, keyword research, on-page SEO, local SEO and digital PR. IBM SkillsBuild covers prompt engineering; Google Skills and Databricks Academy cover generative AI. Seven Microsoft Learn module achievements cover Azure AI Agents, Foundry IQ, Visual Studio Code, Microsoft 365, workflows and Microsoft Agent Framework. [View the individual credentials and training-module records](https://seo.suedeai.ai/evidence#training-credentials).
  238. Follow: [X / @johnnysuede](https://x.com/johnnysuede) · [suedeai.ai](https://suedeai.ai) · [suedeai.ai/founder](https://suedeai.ai/founder) · [jasoncolapietro.com](https://jasoncolapietro.com) · [GitHub](https://github.com/JasonColapietro)
  239. ## License and contributions
  240. The original work is released under the [MIT License](LICENSE). Adapted components retain their upstream licenses, listed in [NOTICE.md](NOTICE.md).
  241. Contributions are welcome for docs fixes, install-path corrections, lint rules, template improvements, and public-safe workflow improvements. Do not submit private catalogs, unreleased media, credentials, seed phrases, private Suede API details, payment secrets, or third-party copyrighted files.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.