MCPInstall

reframe-voice

Write, rewrite, or review content in the evidence-led reframe voice style. Use when the user explicitly asks to write in "reframe voice" or "reframe style". Do NOT use for general writing tasks.

Installs
41
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/sammcj/agentic-coding --skill reframe-voice
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads reframe-voice automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Reframe Voice

An evidence-led thought-leadership style built around a central reframe: taking a common belief and revealing a deeper, more useful way to think about it. The voice is that of a knowledgeable colleague who has done the work, not a lecturer or salesperson.

While this skill is active, its voice spec takes precedence over general writing-style guidance. The signature phrases and contrast patterns below are intentional even where they collide with standing plain-style or banned-phrase rules.

Three Core Principles

  1. Evidence over assertion. Ground every claim in a named study, researcher, company, personal experience, or specific number. Never ask the audience to trust you without proof. Every cited study, researcher, company, or number must be real and verified, via search or user-supplied material. Where you need evidence you cannot verify, use a clearly marked placeholder and flag it to the user rather than inventing a plausible-sounding source or statistic.
  2. Balanced honesty over tribalism. Praise strengths and call out weaknesses regardless of affiliation. "I give credit where it's due" is a signature phrase. Never pick sides.
  3. Practical reframe over surface take. The central move is replacing a widely held belief with a deeper framing. The audience leaves with a shifted mental model, not just new information.

Structural Arc

Every piece follows this order (sections flex in length):

  1. Hook - Bold, contrarian opening. Pattern: [Strong claim] + [immediate complication]. Make them stop scrolling.
  2. Stakes and Context - Why this matters right now. Cite a specific stat, study, or event. Often includes a personal anchor.
  3. The Reframe - The signature move. [Common understanding] is wrong or incomplete. Here is the real issue. Should feel like a lock clicking open.
  4. Evidence and Exploration - The longest section. Mix of named studies, specific numbers, real companies, personal anecdotes, and concrete scenarios.
  5. Named Framework - Distill into a numbered, memorably named structure. Each component gets: definition, what good looks like, what bad looks like.
  6. Practical Application - Advice segmented by audience role ("If you're an engineer...", "If you manage people...", "If you run an organisation...").
  7. Broader Implications - Scale outward. What does this mean for the industry, the economy, the decade?
  8. Close - Brief, forward-looking, personal. No summary. End with "Cheers."

For review/comparison pieces, the reframe may be distributed and the framework may be a scorecard. The underlying rhythm still holds.

Voice

  • Confident but not arrogant. Freely admit what you don't know.
  • Opinionated but evidence-grounded. Earn the right to conclusions.
  • Urgent but not alarmist. Thoughtful action, not panic.
  • Direct but empathetic. Respect the audience. Never talk down.
  • Empathetic toward practitioners doing hard work, even when critiquing their output.

Sentence style: Active voice. Varied length. Short punchy statements for emphasis ("Full stop.") interspersed with longer explanatory sentences. Heavy use of "you" and "your". No jargon without explanation.

Conversational transitions: "Look," / "Here's the thing," / "Let's be honest" / "On we go." / "You get the idea." / "And here's the thing"

Signature phrases: "I give credit where it's due" / "Full stop." / "This is not [X]. It's [Y]." / "Same [X], different [Y]." / "What does bad look like here?" / "I want to be honest with you" / "Cheers."

Never use: Marketing superlatives (game-changing, revolutionary), vague qualifiers without data, tribal dismissals, sycophantic hedging, emoji, filler transitions ("without further ado", "let's dive in").

Seven Rhetorical Techniques

Apply these throughout. For any write or rewrite task, read references/techniques.md before drafting. It holds worked examples of each technique plus load-bearing spec that completes this one: the length target (2,500 to 7,000 words), the content pillars, and the formatting rules.

  1. Specific Analogy - Every major concept gets a vivid, concrete analogy. If they can't picture it, they won't remember it.
  2. Paired Contrast - Same input, different human approach, dramatically different outcome. Pattern: "Same [X]. Different [Y]. Dramatically different [Z]."
  3. Layered Example - For each framework component: what it is, what good looks like, what bad looks like.
  4. Cross-Domain Validation - Prove the same point from 3+ unrelated disciplines.
  5. Personal Anchoring - Concrete first-person experience. Not vague claims ("I've worked in this space") but specific scenes (a kitchen table, a particular eval, a conversation).
  6. Preemptive Rejection - Name and reject the audience's expected objection before they form it.
  7. Honest Concession - Credit the other side before criticising. Acknowledge inconvenient truths.

Quality Checklist

Before finishing, verify:

  • Hook creates tension in the first two sentences
  • Clear reframe shifts the audience's mental model
  • Every major claim grounded in a named source or experience
  • At least one honest concession to the opposing view
  • Framework is named, numbered, and memorable
  • Each framework component has a concrete example
  • Practical advice segmented by audience role
  • Analogies make abstract concepts visual
  • At least one paired contrast
  • Tone: confident, direct, empathetic (not salesy, not tribal)
  • Closes with forward momentum and "Cheers"
  • No marketing superlatives or vague qualifiers

Reference Files

  • references/techniques.md - Detailed examples of all seven rhetorical techniques, content pillars, and formatting rules
  • references/example.md - A fully worked example piece (RAG pipeline evaluation) demonstrating the style. Its citations (studies, companies, figures) illustrate the format only. Do not reuse them as real sources; source and verify your own evidence per principle 1.

FAQ

What does the reframe-voice skill do?

Write, rewrite, or review content in the evidence-led reframe voice style. Use when the user explicitly asks to write in "reframe voice" or "reframe style". Do NOT use for general writing tasks.

How do I install reframe-voice?

Run npx skills add https://github.com/sammcj/agentic-coding --skill reframe-voice in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/reframe-voice/ (personal) or .claude/skills/reframe-voice/ (project).

Which AI agents can use reframe-voice?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is reframe-voice safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains reframe-voice?

It is published by sammcj in sammcj/agentic-coding. It has 41 recorded installs.

More from sammcj/agentic-coding

View all →

Critically analyse the reasoning in written content (articles, blogs, transcripts, reports), not code. Use only when explicitly asked to critically analyse or critique an argument.

AI & Agents2.4K installs

Applies the Diataxis framework to create or improve technical documentation. Use when being asked to write high quality tutorials, how-to guides, reference docs, or explanations, when reviewing documentation quality, or when deciding what type of documentation to create. Helps identify documentation types using the action/cognition and acquisition/application dimensions.

Docs & Writing615 installs

creating-development-plans

sammcj/agentic-coding

Creates structured development plans with phased task breakdowns, requirements, and QA checklists. Use when the user explicitly asks to create a dev plan, development plan, or document development requirements.

ghostty-config

sammcj/agentic-coding

Open the skill to read its SKILL.md instructions.

AI & Agents221 installs

code-simplification

sammcj/agentic-coding

Open the skill to read its SKILL.md instructions.

AI & Agents203 installs

prompt-enhancer

sammcj/agentic-coding

Open the skill to read its SKILL.md instructions.

AI & Agents184 installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs