SKILL·D0A50B

suede-clip-to-guide

JasonColapietro
Updated 18 days ago
5 views
139
8
139
View on GitHub
Metaaidesign

About

This skill provides a structured blueprint for converting video clips or transcripts into a complete content funnel package that drives attention to a long-form written asset. It includes moment scoring, exact post copy, publishing sequences, and approval workflows for repeatable execution. Use it specifically for creating this short-to-long bridge, not for full video editing, general social posting, or creating the long-form asset from scratch.

Quick Install

Claude Code

Recommended
Primary
npx skills add JasonColapietro/suede-creator-skills -a claude-code
Plugin CommandAlternative
/plugin add https://github.com/JasonColapietro/suede-creator-skills
Git CloneAlternative
git clone https://github.com/JasonColapietro/suede-creator-skills.git ~/.claude/skills/suede-clip-to-guide

Copy and paste this command in Claude Code to install this skill

Documentation

Suede Clip to Guide

Build one evidence-backed path from a video moment to a deeper written asset. Treat the clip as the attention layer and the guide as the authority layer. Do not assume the pattern performs; test the bridge against the account baseline.

Default Success Blueprint

Use this as the recommended pattern when the rights, source, claim, platform, and approval gates pass:

Useful guide with one promise
        ↓
Self-contained video moment
        ↓
Rights route + 8/10 moment score
        ↓
Clip hook + source credit + subtitles
        ↓
Post explains why the moment matters
        ↓
One explicit bridge to the guide
        ↓
Full Send/Fleet: dual certainty gate
        ↓
Exact-content approval
        ↓
Public readback + clip-to-guide measurement
        ↓
Keep, revise, or stop from the observed result

Prefer this blueprint when:

  • a guide already answers the natural next question created by the clip;
  • the goal is deeper understanding, bookmarks, qualified replies, leads, or authority rather than raw views alone;
  • the selected moment passes the 8/10 score and claim-support threshold;
  • the rights route and current platform sequence are recorded;
  • the account can observe at least one clip metric and one guide-transition or campaign metric.

Do not use it when:

  • the guide is thin, unrelated, unpublished without a stable draft, or has no specific promise;
  • the clip needs missing context, distorts the source, or exists only because it is popular;
  • third-party reuse is blocked or the accountable fair-use decision is absent;
  • the platform cannot preserve the source, clip, and guide bridge in a verified sequence;
  • the idea is complete in the short post and the guide would add no depth.

For a first test, build three distinct packages only when three moments pass all gates. Compare them with the account's recent comparable posts. Keep the pattern only if the named guide-transition or campaign metric meets the decision rule; revise one variable at a time when it does not.

Non-Negotiable Gates

Apply these throughout the run. Resolve rights, source, and claims before writing copy; resolve platform, certainty, and approval before a live action:

  1. Rights gate — classify the video as owned, licensed, permission-recorded, native-repost-only, fair-use-review, or blocked. Public availability is not reuse permission.
  2. Source gate — obtain the video, transcript or exact timestamps, guide draft or URL, target platform, intended account, and desired next action.
  3. Claim gate — trace factual claims and quotations to the source. Label interpretations as interpretations.
  4. Platform gate — inspect current official requirements and the live composer before promising that media, quote-posts, article cards, links, or replies can be combined.
  5. Approval gate — do not publish, schedule, repost, upload, reply, or edit a live article until the user approves the exact media, copy, guide, account, and sequence.
  6. Certainty gate — when suede-full-send or suede-codex-fleet controls the run, require two distinct evidence checks before marking a package approved or published. A worker conclusion is not the second check.

When a blocking gate fails, stop the affected action and return:

HALT — <one-line blocker>
Options:
1. <bounded resolution>
2. <bounded resolution>
3. <bounded resolution, if useful>
Waiting on: <specific evidence or approval>

Continue only on independent draft work that does not bypass the blocker.

Workflow

1. Define the funnel contract

Capture:

  • campaign goal: article reads, bookmarks, qualified replies, profile visits, leads, or another named action;
  • target platform and visible posting identity;
  • video source URL or file, owner, transcript availability, and candidate timestamps;
  • guide title, URL or draft, its promise, and current publication state;
  • audience and one next action;
  • whether the user wants a private draft, scheduled package, or live execution.

If product-marketing context exists in .agents/product-marketing.md, .claude/product-marketing.md, or product-marketing-context.md, read it before asking for information already covered there.

2. Choose a lawful video route

Rights statusAllowed route
originalCut and publish within the user's approved scope.
licensedFollow the license terms and record the evidence.
permission-recordedFollow the exact approved platforms, duration, credit, and edit scope.
native-repost-onlyUse the platform's native quote, repost, stitch, duet, embed, or link path. Do not download and re-upload. Treat this as an operational sharing route, not legal clearance.
fair-use-reviewPrepare a four-factor review for commentary, criticism, news reporting, teaching, scholarship, or research. Do not label the use fair or publish until the accountable owner records the decision.
blockedDo not use the footage. Offer an original commentary clip, a permission request, or a source link instead.

For any source that is not original, licensed, or permission-recorded, read references/third-party-video-rights.md. Do not infer fair use, ownership, or permission. Shortness, credit, a public source, or added commentary alone does not settle fair use. Do not remove watermarks, attribution, or provenance. Prefer a native repost with added analysis or create an original camera or screen-recorded response that summarizes the idea without copying the footage.

3. Establish the guide anchor

The long-form asset must have:

  • one specific promise that the clip can honestly introduce;
  • a title and stable draft or URL;
  • enough depth to reward the transition from short to long;
  • sources for material factual claims;
  • one next action that matches the campaign goal.

If the guide does not exist, return a brief and route the full draft to suede-copy and the portfolio decision to suede-content-strategy. Resume this skill after the guide has a reviewable draft. Do not fabricate a live URL.

4. Score candidate moments

Score each candidate from 0 to 2 on five dimensions:

Dimension012
Opening clarityPremise is missingPremise arrives latePremise is clear in 1–3 seconds
Standalone valueNeeds surrounding contextPartly self-containedComplete useful idea or story
Guide bridgeUnrelatedAdjacentNaturally creates the next question the guide answers
Claim supportUnverifiable or misleadingNeeds qualificationDirectly supported and correctly framed
Audience fitNo named audience fitBroad fitSolves a named audience problem

Select a moment only when it scores at least 8/10, claim support is 2, guide bridge is 2, and the rights gate passes. If none qualify, return the scorecard and request a better source instead of forcing a clip.

5. Build the package

Read references/package-template.md and produce:

  1. Decision snapshot — goal, audience, platform, identity, and chosen sequence.
  2. Source and rights record — owner, source, evidence, transcript excerpt, permitted route, jurisdiction, and any four-factor review.
  3. Guide anchor — exact title, promise, URL or draft state, and the question it answers after the clip.
  4. Clip brief — in/out timestamps, target duration, exact opening, subtitle text, on-screen credit, ending bridge, and export owner.
  5. Funnel post — exact text with four jobs:
    • hook the video moment;
    • explain why it matters;
    • bridge to the deeper guide;
    • give one specific next action.
  6. Publish sequence — one of the verified patterns below.
  7. Measurement plan — baseline, observation window, and decision rule.
  8. Certainty record — execution mode, two check owners or processes, direct evidence, contradictions, and final verdict.
  9. Approval bundle — exact media, post copy, guide, identity, and sequence.

Do not pad the post with generic setup, unsupported performance language, or multiple competing calls to action.

6. Choose a verified sequence

Use one:

  • Anchor-first — publish or verify the guide, then publish the clip-led post that references it.
  • Clip-first — publish the clip, then place the guide in the platform's verified companion location, such as a first reply or supported link field.
  • Native-repost — quote or repost the third-party source with original analysis and a guide bridge; do not re-upload the source media.

Do not assume a quote-post can also carry new media. Verify the current composer and choose the smallest sequence that preserves the clip, guide, and source credit.

7. Run the dual certainty gate when required

Record execution_mode as standard, full-send, or codex-fleet. Standard mode may record certainty_status: not-required. Full Send and Codex Fleet must run both checks and may not mark a package approved or published until certainty_status: proved. Record one package version, timestamp, or content hash so both checks evaluate the same unchanged artifact.

Check 1 — production proof

  • Reopen the video or transcript at the selected timestamps.
  • Match the quotation, claim framing, rights evidence, moment score, guide promise, bridge, exact copy, identity, sequence, and one CTA to the package.
  • Run the package validator for a saved artifact.
  • In Fleet mode, the Codex worker's acceptance-criteria self-check may satisfy this check, but remains provisional.

Check 2 — independent proof

  • Inspect the source evidence and assembled package directly; do not review only Check 1's summary.
  • Use a different failure lens, evidence source, or acceptance criterion and try to disprove the rights route, factual framing, guide fit, platform sequence, and approval readiness.
  • In Full Send with useful parallel work, keep the producer and adversarial reviewer separate. For one atomic Full Send job, perform a fresh second pass after reloading the source evidence.
  • In Fleet mode, the controller must perform this check and mark the worker output accepted, rejected, or fix brief. A second worker or repeated self-check does not replace controller review.

Use only:

  • PROVED — both checks pass with direct evidence and every contradiction is resolved;
  • UNPROVED — a check is incomplete, indirect, or disagrees with the other;
  • BLOCKED — access, authority, rights, or platform state prevents a required check.

If either check is not PROVED, keep publication unapproved, use the halt format, and name the smallest fix or evidence needed. The dual check raises confidence; it does not guarantee truth, create legal clearance, or replace the live readback. A material change to the media, timestamps, rights evidence, guide, copy, identity, sequence, or CTA resets certainty_status to pending and requires both checks again.

8. Require exact-content approval

Before a live action, show:

Account:
Platform:
Media:
Source/rights status:
Guide title and URL:
Exact post text:
Publish sequence:

Approval is valid only for that bundle. If the media, copy, guide URL, account, or sequence changes materially, show the changed bundle and obtain approval again. Verify the visible identity immediately before acting and fail closed on an account mismatch, login challenge, or ambiguous composer.

9. Verify completion

For a saved package, run:

python3 scripts/validate_package.py path/to/clip-to-guide-package.md

For a live run, also read back:

  • the final public permalink;
  • visible posting identity;
  • rendered post text and media or native source reference;
  • guide URL and publication state;
  • timestamp and any platform warning.

Do not claim publication from a click alone. A complete live run needs the public readback. A draft-only run is complete when the package validator passes and the approval state is reported as draft.

Measurement

Choose the smallest comparable window the account can support. Record:

  • clip retention or completion where exposed;
  • guide opens or link clicks where exposed;
  • bookmarks, saves, qualified replies, and profile visits;
  • the exact campaign action;
  • a comparable recent baseline.

When the platform exposes compatible denominators, calculate:

guide transition rate = verified guide opens / clip-post impressions
qualified action rate = named qualified actions / verified guide opens

If compatible denominators are unavailable, report the available counts separately. Do not combine mismatched platform windows or call clicks article reads.

Change one variable per next test: moment, opening, bridge, sequence, or CTA. Do not report causal lift from an unpaired or tiny sample.

Boundaries

  • Do not download, clip, or re-upload third-party footage without a recorded rights basis or an accountable fair-use decision.
  • Do not give legal clearance or label uncertain reuse as fair use.
  • Do not invent transcripts, timestamps, permissions, URLs, performance, audience demand, or platform capabilities.
  • Do not publish or schedule without exact-content approval and visible-identity verification.
  • Do not alter a source quote to make the hook stronger.
  • Do not describe the campaign as successful until current analytics support the named decision rule.
  • Do not call a Full Send or Fleet package certain, approved, or publishable when either required check is UNPROVED or BLOCKED.

Routing

  • Need full video editing, generation, captions, color, or exports -> use suede-video, then return here for the funnel package.
  • Need a general platform plan, calendar, listening, or engagement program -> use suede-social.
  • Need the long-form guide written -> use suede-copy; use suede-content-strategy for pillars and portfolio priority.
  • Need paid variants -> use suede-ad-creative.
  • Need maximum-effort orchestration -> use suede-full-send; need a high-volume Codex CLI batch -> use suede-codex-fleet. In either mode, return here for the dual certainty record.
  • From those skills, route a video-to-long-form bridge, moment score, rights route, exact approval bundle, and readback back to suede-clip-to-guide.

GitHub Repository

JasonColapietro/suede-creator-skills
Path: skills/suede-clip-to-guide
0
agent-orchestrationagent-skillagent-skillsai-agentsai-codinganthropic
FAQ

Frequently asked questions

What is the suede-clip-to-guide skill?

suede-clip-to-guide is a Claude Skill by JasonColapietro. Skills package instructions and resources that Claude loads on demand, so Claude can perform suede-clip-to-guide-related tasks without extra prompting.

How do I install suede-clip-to-guide?

Use the install commands on this page: add suede-clip-to-guide to Claude Code as a plugin, or clone its repository into your skills directory, then restart Claude so it picks up the skill.

What category does suede-clip-to-guide belong to?

suede-clip-to-guide is in the Meta category.

Is suede-clip-to-guide free to use?

Yes. suede-clip-to-guide is listed on AIMCP and free to install.

Related Skills

content-collections
Meta

This skill provides a production-tested setup for Content Collections, a TypeScript-first tool that transforms Markdown/MDX files into type-safe data collections with Zod validation. Use it when building blogs, documentation sites, or content-heavy Vite + React applications to ensure type safety and automatic content validation. It covers everything from Vite plugin configuration and MDX compilation to deployment optimization and schema validation.

View skill
polymarket
Meta

This skill enables developers to build applications with the Polymarket prediction markets platform, including API integration for trading and market data. It also provides real-time data streaming via WebSocket to monitor live trades and market activity. Use it for implementing trading strategies or creating tools that process live market updates.

View skill
creating-opencode-plugins
Meta

This skill helps developers create OpenCode plugins that hook into 25+ event types like commands, files, and LSP operations. It provides the plugin structure, event API specifications, and implementation patterns for JavaScript/TypeScript modules. Use it when you need to intercept, monitor, or extend the OpenCode AI assistant's lifecycle with custom event-driven logic.

View skill
sglang
Meta

SGLang is a high-performance LLM serving framework that specializes in fast, structured generation for JSON, regex, and agentic workflows using its RadixAttention prefix caching. It delivers significantly faster inference, especially for tasks with repeated prefixes, making it ideal for complex, structured outputs and multi-turn conversations. Choose SGLang over alternatives like vLLM when you need constrained decoding or are building applications with extensive prefix sharing.

View skill