Agent skill

Reframe Voice

by sammcj in sammcj/agentic-coding

Write, rewrite, or review content in the evidence-led reframe voice style.

Apache-2.0Auto-check passed

Install Reframe Voice

skills CLI
$ npx skills add sammcj/agentic-coding --skill reframe-voice -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sammcj/agentic-coding reframe-voice --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sammcj/agentic-coding.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills_disabled/reframe-voice .claude/skills/reframe-voice && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
reframe-voice
GitHub stars
162
Token cost
~1.6k tokens
SKILL.md length
842 words
Files
3 (incl. references)
Skills in repo
64
Repo updated
First seen
Licence
Apache-2.0

At a glance

Write, rewrite, or review content in the evidence-led reframe voice style.

  • Works in 3 steps: Evidence over assertion. Ground every… → Balanced honesty over tribalism. Praise… → Practical reframe over surface take. The…
  • The user explicitly asks to write in reframe voice
  • SKILL.md covers Three Core Principles, Structural Arc, Voice and Seven Rhetorical Techniques, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Reframe Voice is an agent skill from sammcj/agentic-coding. 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.

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `references/example.md` and `references/techniques.md`).

The repository describes itself as: Agentic Coding Rules, Templates etc... The licence is Apache-2.0.

When your agent uses it

  • The user explicitly asks to write in reframe voice
  • General writing tasks

Example prompts

  • “reframe voice”
  • “reframe style”
  • “/reframe-voice”

Requirements

  • Pre-approved tools (allowed-tools): Read, Write, Edit, Grep, Glob

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Evidence over assertion. Ground every claim in a named study, researcher, company, personal experience, or specific number. Never ask the…
  2. Balanced honesty over tribalism. Praise strengths and call out weaknesses regardless of affiliation. "I give credit where it's due" is a…
  3. Practical reframe over surface take. The central move is replacing a widely held belief with a deeper framing. The audience leaves with a…

What it can do on your machine

Read from SKILL.md and the folder at commit 2f25ced. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Grep
    • Glob

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Reframe Voice loads about 1.6k tokens when it runs, and up to ~7.5k if it reads all its reference files. Until then it costs about 52 tokens; SKILL.md has 842 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~7.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sammcj/agentic-coding at commit 2f25ced, republished under its Apache-2.0 licence (© sammcj). 842 words, ~1,580 tokens.

Download SKILL.mdSave it as .claude/skills/reframe-voice/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
reframe-voice
description
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.
allowed-tools
Read, Write, Edit, Grep, Glob

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").

Show full SKILL.md (303 more words)Show less

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.

© sammcj, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in Skills_disabled/reframe-voice of sammcj/agentic-coding.

  • SKILL.md
  • references/example.md
  • references/techniques.md

Open the folder on GitHubat commit 2f25ced

Compare with similar skills

Reframe Voice next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Reframe Voice compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Reframe Voice this skillsammcj/agentic-coding162—~1.6kAutomated safety check: PassApache-2.0
Rewrite Plannexu-io/open-design100k—~511Automated safety check: PassApache-2.0
Run Devicelab With Ledflutter/flutter179k—~786Automated safety check: PassBSD-3-Clause
RewriteNxcoreAI/EverRoom3k—~124Automated safety check: PassCustom licence
Novel to Screenplay Rewriterchatfire-AI/huobao-drama16k—~209Automated safety check: PassCustom licence
Article Rewriterdigoal/blog8.6k—~675Automated safety check: PassGPL-2.0

Similar skills

  • Rewrite Plan

    nexu-io/open-design

    Author a long-running multi-file rewrite plan that subsequent patch-edit + diff-review + build-test stages will execute, with explicit ownership boundaries and patch-safety guarantees.

    100k GitHub stars~511 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Run Devicelab With Led

    flutter/flutter

    Run DeviceLab tests for Flutter PRs using LUCI's led CLI tool.

    179k GitHub stars~786 tokensUpdated today
    MobileAuto-check passed
  • Rewrite

    NxcoreAI/EverRoom

    Rewrite only the supplied selectedText per the instruction and return the replacement fragment.

    3k GitHub stars~124 tokensUpdated today
    Auto-check passed
  • Novel to Screenplay Rewriter

    chatfire-AI/huobao-drama

    Rewrites narrated novel chapters into a formatted screenplay with scene headers and dialogue, keeping the plot and cutting camera directions.

    16k GitHub stars~209 tokensUpdated 3 days ago
    Writing & ContentAuto-check passed
  • Article Rewriter

    digoal/blog

    给定一篇文章的 URL 或全文内容,深度阅读消化后,以更高屋建瓴的视角创作一篇全新文章: 提取核心观点+基石假设,找逻辑漏洞或用第一性原理重构假设,续写新内容,最终输出图文并茂的 Markdown 文章。

    8.6k GitHub stars~675 tokensUpdated today
    Auto-check passed
  • Blog Rewrite

    AgriciDaniel/claude-blog

    Rewrite and optimize existing blog posts for Google SEO (May 2026 Core Update, E-E-A-T) and AI citation visibility as one SEO discipline.

    2.3k GitHub stars~4.6k tokensUpdated today
    Writing & ContentAuto-check passed

More from sammcj/agentic-coding

All 64 skills in this repo
  • Yue2 Music

    sammcj/agentic-coding

    A skill your agent uses when generating songs with YuE2, covering a recording via SheetSage2 audio-to-ABC, editing a score or lyrics with melody preservation, or building a reproducible listening…

    162 GitHub stars~2.3k tokensUpdated today
    Auto-check passed
  • Bento Slides

    sammcj/agentic-coding

    A skill your agent uses when creating or editing Bento (.bento.html) slide decks, including any request for a single-file HTML slide deck.

    162 GitHub stars~2.9k tokensUpdated today
    Auto-check passed
  • Idrive Backup

    sammcj/agentic-coding

    A skill your agent uses whenever the user wants you to manage, discuss or diagnose iDrive Backup configuration on macOS

    162 GitHub stars~1.7k tokensUpdated today
    Auto-check: notes
  • Piper Tts Training

    sammcj/agentic-coding

    Train custom TTS voices for Piper (ONNX format) using fine-tuning or from-scratch approaches.

    162 GitHub stars~1.4k tokensUpdated today
    Auto-check passed
  • PPTX To Md

    sammcj/agentic-coding

    Convert a PPTX slide deck into per-slide markdown that preserves both the verbatim text and the meaning of embedded screenshots, diagrams and charts in their original layout positions.

    162 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Skill Creator Primer

    sammcj/agentic-coding

    You MUST load this skill before the skill-creator skill AND before making ANY change to, or conducting a review of ANY Agent Skill.

    162 GitHub stars~9.8k tokensUpdated today
    Auto-check passed

Questions about Reframe Voice

What does Reframe Voice do?

Write, rewrite, or review content in the evidence-led reframe voice style. Reframe Voice is an agent skill from sammcj/agentic-coding. Write, rewrite, or review content in the evidence-led reframe voice style.

When should I use Reframe Voice?

Reframe Voice fits situations like: the user explicitly asks to write in reframe voice; general writing tasks.

How do I install Reframe Voice in Claude Code?

Run `npx skills add sammcj/agentic-coding --skill reframe-voice -a claude-code`. Or copy the skill folder (Skills_disabled/reframe-voice in sammcj/agentic-coding) into .claude/skills/reframe-voice in your project. Claude Code loads it when a task matches its description.

How do I install Reframe Voice in Codex?

Run `npx skills add sammcj/agentic-coding --skill reframe-voice -a codex`. Or copy the skill folder (Skills_disabled/reframe-voice in sammcj/agentic-coding) into .agents/skills/reframe-voice in your project. Codex loads it when a task matches its description.

Can I use Reframe Voice in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sammcj/agentic-coding --skill reframe-voice -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/reframe-voice, .gemini/skills/reframe-voice, .github/skills/reframe-voice and .opencode/skills/reframe-voice in your project.

What does Reframe Voice need to run?

SKILL.md names no scripts, command-line tools or credentials: Reframe Voice is instructions for the agent only. Its frontmatter pre-approves these tools: Read, Write, Edit, Grep, Glob.

Does Reframe Voice access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Reframe Voice safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Reframe Voice use?

Reframe Voice is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Reframe Voice use?

About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5.9k tokens, read only when the agent opens those files.

What are the alternatives to Reframe Voice?

Skills that share tags, products or a category with Reframe Voice: Rewrite Plan (nexu-io/open-design, 100k stars), Run Devicelab With Led (flutter/flutter, 179k stars), Rewrite (NxcoreAI/EverRoom, 3k stars) and Novel to Screenplay Rewriter (chatfire-AI/huobao-drama, 16k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Reframe Voice?

sammcj (a GitHub user) maintains it in sammcj/agentic-coding, which has 162 GitHub stars. The repository holds 64 skills in this directory. The repository was last updated on October 9, 2026.

Source: sammcj/agentic-coding on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.