Skip to content
Skills Library
Marketing & content · Writing

write

/write

Write a social post in one of the roster's voices (or the user's own `self` voice) — platform-native, craft-floored, scanner-verified. Use when the user wants a post, caption, announcement, reply, or any short-form text written as a distinct human voice.

Repository
idiolect ↗
Licence
MIT
Last repository change
08.07.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 08.07.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Write a social post in one of the roster's voices (or the user's own `self` voice) — platform-native, craft-floored, scanner-verified. Use when the user wants a post, caption, announcement, reply, or any short-form text written as a distinct human voice.

Triggers from the description

s voices (or the user

Arguments

/write <voice-slug|pick> <platform> — <brief>
Original author description

Write a social post in one of the roster's voices (or the user's own `self` voice) — platform-native, craft-floored, scanner-verified. Use when the user wants a post, caption, announcement, reply, or any short-form text written as a distinct human voice.

How it works

  1. Setup
  2. Flow
  3. Register notes
Original SKILL.md headings · 50 lines, 689 words
SKILL.md preview
---
name: write
description: Write a social post in one of the roster's voices (or the user's own `self` voice) — platform-native, craft-floored, scanner-verified. Use when the user wants a post, caption, announcement, reply, or any short-form text written as a distinct human voice.
argument-hint: "<voice-slug|pick> <platform> — <brief>"
---

# /idiolect:write — one post, one person, verified

You are about to write as a specific human being. Not "in a casual tone" — as a person with a biography, grudges, a phone number, and systematic typing habits. The engine measures whether you succeeded.

## Setup

Resolve the engine (works on Claude Code, Codex, opencode):

```bash
ROOT="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-$IDIOLECT_ROOT}}"
# If all three are unset (e.g. opencode skill install), ROOT = two directories
# up from this SKILL.md file (skills/write/SKILL.md -> repo root).
IDIO="python3 $ROOT/scripts/idiolect.py"
```

Free text (briefs, drafts) reaches the engine ONLY via files or stdin — write it with the Write tool to a scratch file and pass `--file`. Never inline user text into a shell command (quoting bugs become injection).

## Flow

1. **Parse the ask.** Voice, platform, brief — all optional except some notion of what to say. Voices may arrive as fuzzy human references ("the HVAC guy", "the Vietnamese food-truck lady", "someone young and lowercase"): resolve them against `$IDIO voices --json` (display/archetype/locale/domains) and proceed, mentioning the match in passing. No platform stated → infer from the ask and say which you assumed. Never require a flag or a slug from the user.

2. **Pick the voice** (if not specified): write the brief to a scratch file, then
   `$IDIO pick --platform <p> --brief-file <f> --n 3 --distinct --json`
   Choose the best fit from the three and tell the user in one line who you chose and why. `self` is a valid voice if the user has built one (`$IDIO voices` shows it).

3. **Become the person.** Read, fully: the voice profile (path from `voices --json`), `$ROOT/skills/_shared/craft.md`, and the platform's row + judgment calls in `$ROOT/skills/_shared/platforms.md`. The profile's exemplars are your few-shot anchor; the frontmatter is your hard constraint set; the stance engine tells you what this person would actually SAY about the brief — which is the difference between costume and voice.

4. **Vary the structure.** Decide opener type (scene|question|price|claim|address|fact), shape (story|tip|list|rant|announcement|reply), length bucket (short|med|long), then
   `$IDIO ledger check --voice <slug> --opener <o> --shape <s> --len <l>`
   If it reports collisions with recent posts, change ≥2 axes. Same person, different day.

5. **Draft.** Craft floor first (one job, exact numbers, honest hook, no wrap-up ending), voice second (their words, their flaws — applied per the error profile's RULES, not sprinkled), platform grammar third. Honesty rules from craft.md are hard: never invent verifiable claims; track invented interior texture. Stay inside the voice's `competence`: if the brief drifts past their range, do what `off_turf` says (deflect / analogize / admit / decline) — never borrow expertise this person would not have. Let `passions` and `mood` bend the prose per craft.md's "Soul: friction, not declaration" — a favorite topic writes longer and sharper; it is never announced.

6. **Verify — the loop that makes this plugin different.** Write the draft to a scratch file, then:
   `$IDIO scan --file <f> --platform <p>` — target: score ≤ 15 (≤ 20 if the voice's formality ≥ 0.6; formal registers legitimately carry more T3 vocabulary).
   `$IDIO conform --file <f> --voice <slug>` — must PASS.
   Fix what the reports point at (they give line numbers and per-check targets) and re-run. Up to 3 revisions; if still failing, ship the best version and say plainly which check fails and why you judged it acceptable.

7. **Record.** `$IDIO ledger add --voice <slug> --platform <p> --opener <o> --shape <s> --len <l> --file <f>`

8. **Deliver.** The post in a plain fenced block (copy-pasteable), then one receipt line:
   `receipt: scan 7/100 (clean) · conform PASS · structure price/story/med · ledger recorded`
   If you invented interior texture (a mood, a domestic detail), add a `texture:` line listing it so the user consciously keeps or cuts it. If the brief needed a factual claim you didn't have (a stat, a testimonial), say so — never fabricate one.

## Register notes

- The scanner is a linter, not a judge of souls; when it flags something the voice genuinely would say (Desmond's "arguably"), keep the voice and say you overrode the linter and why.
- One post = one platform. Cross-posting is what `/idiolect:campaign` is for, because reformatting is not re-voicing.

Versions

RepositoryScoreLicence
This page · nagisanzenin/idiolect100MIT
tw93/Waza100MIT
mimshins/ork100MIT
waynesutton/builder-skills100Apache-2.0
iankiku/forwward-teams100MIT
petitchu/holocron100MIT
unclejobs-ai/second-claude-code96MIT
researai/deepscientist95Apache-2.0
markusleben/ha-nova90MIT

Database snapshot: 13.11.2026 · package version 4f334025e134 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100social-post
    Write a platform-native social media post for a music release, show announcement, or general artist content. Load artist-context.md and promotion-strategy.md before running. Use when asked to "write a caption," "write a post for [platform]," or "help me announce [thing].
  • 100caption-writer
    Use to write platform-native social media captions (post copy) in the brand's voice — the words that accompany a post on Instagram, LinkedIn, TikTok, Facebook, X/Twitter, Threads, Pinterest, YouTube, or Bluesky. Run when the user says "write a caption," "caption this," "post…
  • 100write-as-me
    Draft text in the user's own voice using their write-like-me voice pack - chat replies, emails, posts, docs. Use whenever the user asks to write, draft or reply "as me", "in my voice", "like I would", "sound like me", "draft a reply to <person>", "write an email to <person>…
  • 100tone-of-voice
    Write posts in the user's own voice, with no AI giveaways, and shape one idea into a draft for each platform (LinkedIn, X / Threads, Instagram, TikTok, YouTube Shorts, email, newsletter, short video script). Use when the user wants a post, caption or script that sounds like…
  • 100write-script
    Write one short-form video script for a content item in the owner's own voice. Remix first (closely remake a proven post, a competitor's outlier or the owner's own breakout, from its checked blueprint, changing only the topic specifics, the proof and the words), otherwise write…
  • 82post-voice
    Use when writing a post, a manual page or an article in the author's own voice.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.