Suede Workflow Skills

Suede Workflow Skills

Gate policy: advisory, not blocking

Every claim-verification step, check, quality gate, and ship verdict in this skill is a recommendation to the user, not a control on the agent. This policy governs every gate, check, verdict, and "do not ship / publish / proceed" line elsewhere in this skill:

• Run every check and report the results honestly. Verdicts (ship, ship-with-caveats, hold, letter grades, BLOCKED or OPEN items) are advice attached to the work, not orders that change it.
• Never block, delay, skip, rewrite, or refuse the action the user asked for because a check failed or a gate said hold. Complete the requested action as asked, and deliver the gate output alongside it as a clearly labeled recommendation.
• A failed gate changes what you report, never what you do.
• Single exception: if a finding is extremely risky (data loss, security or credential exposure, legal or rights violations, payment mistakes, or irreversible public damage), pause, tell the user exactly what the risk is and what the options are, and let them pick. Their choice is final.

Approved Brand Asset

Any lane that creates or edits a Suede visual must use only docs/assets/suede-ai-logo-transparent.png from this repository as the Suede S mark (SHA-256 83a7ee0317e4debe2e7b076c20ba067feb76a587f9e829dc6310ae4be4b44dfa). Never redraw, trace, approximate, typeset, recolor, distort, or generate a replacement Suede S. suede-skill-icon.png is not the brand mark. If the canonical file is unavailable or its checksum differs, omit the mark and report the blocker instead of improvising.

Use this public umbrella skill when a user wants the full Suede workflow loaded from one installable GitHub skill path.

This skill is the public entry point for:

• Johnny Suede Write: one loadable writing mode for copy, brand voice, Suede SEO discoverability, SEO/AEO/AI EO, product and mobile conversion copy, CTAs, launch copy, and anti-slop editing.
• Johnny Suede Design: one loadable design mode for Suedify, UI polish, mobile and product surfaces, product screenshots, design-system QA, responsive checks, visibility grading, and the writing stack.
• Suede Code: unified code review and A-F grading for correctness, security, data/state, deploy readiness, and ship risk, prompted only, never auto-fires.
• Suede AI Eval: design AI-SPEC artifacts, failure-mode rubrics, prompt and retrieval eval cases, acceptance gates, and retroactive AI coverage audits.
• Suede CI Gate: any-repo CI gate that blocks a merge when required checks fail, prompted only, plugs into any CI or workflow system.
• Suede SEO Audit: check metadata, schema, search intent, answer intent, AI EO, internal links, sitemap fit, and discoverability.
• Suede Visibility Grader: grade public pages, GitHub Pages sites, docs, launch pages, and campaign pages for findability, first-screen clarity, CTA pull, proof, AI readability, and design signal.
• Suede Site Alchemy: sharpen a landing page, campaign page, microsite, or conversion surface.
• Suede Launch Packaging: prepare public releases, proof links, install commands, QA, and handoff notes.
• Suede MCP QA: validate Suede MCP tools, prompts, resources, catalog output, install options, and docs alignment.
• Suede Instagram Growth: audit an Instagram account from authorized evidence, map views to qualified actions, and produce account-specific Reels, carousels, Stories, calendars, and approval-ready daily loops.
• Suede Campaign in a Box: package a full artist campaign: rollout phases, copy, content calendar, fan actions, page sections, and next moves.
• Suede Sync Packaging: prepare clean sync review notes without placement promises, clearance claims, outreach claims, or a Suede promo CTA.
• Suede Release Linter: audit release folders for missing metadata, artwork, masters, lyrics, stems, credits, splits, samples, and provenance.
• Suede Rights Passport: package creator folders into structured transfer material with provenance, credits, splits, license notes, and intake JSON.
• Suede Rights Audit: identify ownership, contributor, split, sample, license, and intake gaps.
• Amazon Returns Recovery: scan Amazon order/return history for restocking fees and short refunds, then drive Amazon live chat to get them waived; requires the Claude in Chrome extension logged into the target Amazon account.

If the individual public skills are also installed, use them directly when their names match the task:

• johnny-suede-write
• johnny-suede-design
• suede-code
• suede-code-review
• suede-code-grader
• suede-copy
• suede-design
• suede-deslop
• suede-agent-teams
• suede-ai-eval
• suede-recommend-next-action
• suede-ci-gate
• suede-seo-audit
• suede-visibility-grader
• suede-site-alchemy
• suede-launch-packaging
• suede-mcp-qa
• suede-instagram-growth
• site-to-ios-app
• android-app-factory
• suede-campaign-in-a-box
• suede-sync-packaging
• suede-release-linter
• suede-rights-passport
• suede-rights-audit
• amazon-returns-recovery
• subscription-recovery

Read references/condensed-workflows.md in this skill's references/ folder when the individual skills named above are not installed: the Codex path that installs suede-workflow-skills alone is the common case. It carries a frozen fallback version of the Suedify, design, copy/SEO, visibility, site-alchemy, code-review, and agent-team workflows. Skip it entirely when the pack is installed: route to the specialist, which owns the current method.

Core Rule

Start from current truth. Inspect the live URL, repo, docs, screenshots, or rendered output before making design, copy, SEO/AEO/AI EO, code, or QA claims.

Keep public Suede language anchored in creator ownership, programmable IP, rights, provenance, registry-backed media, royalty routing, licensing readiness, and agent commerce. Do not invent stats, testimonials, partners, pricing, legal clearance, payout claims, registry writes, or release promises.

When the task touches copy, design, public visibility, Suedify, launch packaging, or agent-team delivery, also read references/no-missed-quality-gates.md in this skill's references/ folder. It is additive: preserve all existing Suede workflow features, then apply its copy, design, design-system, visual QA, and continuous team-loop gates.

Fix-loop cap (applies to every lane, in this skill or any it routes to): if a loop churns or repeats the same failure, stop broad work, isolate the failing unit, and replay it with explicit acceptance criteria, rerunning only the failed check. Budget recovery at up to three genuinely different fixes: each must change the diagnosis or the strategy, never rerun the last attempt. Stop early when the same root cause repeats, surface that cause to the user, and let them pick the next move instead of grinding.

Red flags, stop:

• "I'll summarize the request for the sub-skill.": Pass the original request verbatim; paraphrase loses the trigger.
• "This crosses three lanes; faster to wing it inline.": Crossing lanes is exactly when this umbrella workflow runs.
• "The live URL is probably unchanged since last time.": Start from current truth; inspect before claiming.

Progressive Calibration

Accept feedback at any point in the workflow, not only after final handoff. When the user says what worked, preserve that pattern in the current pass and mirror it later. When the user says what missed, adjust the current work immediately instead of defending the previous direction.

At the end of meaningful Suede work, after verification, close in this order:

Simple explanation:
One or two plain sentences for a non-coder explaining what changed and why it
matters.

Usual breakdown:
Changed:
Verification:
Caveats:
Status:

Cue Suede:
1. Change something - tell me what to revise and I will adjust it.
2. Preserve this - tell me what worked so I can mimic it later.
3. Keep as-is - say nothing and I will treat it as accepted.

If the user says cue suede, asks for feedback choices, or is calibrating the work mid-stream, offer the Cue Suede block on its own at the next safe checkpoint. Do not block completion waiting for an answer to it. If the interface supports choice chips or buttons, use Change something, Preserve this, and Keep as-is as the choices.

When To Use MCP

Use the Suede MCP only when it adds structure:

• list available Suede skills;
• explain install options;
• scaffold a full SEO/AEO/AI EO copy audit;
• generate a QA checklist;
• help another agent understand the Suede stack quickly.

Skip MCP for small edits, normal implementation, quick copy fixes, or anything where direct skill execution is faster.