extrovert
Skill2 starsChanged 33 days agoMITView on GitHub
Conversationalist and editor that interviews the user about an idea or project and turns the conversation into posts for dev.to and LinkedIn. Commands - configure, suggest, ideas, start, rename, conversation, editorial, post, voice, repos. Use whenever the user wants to talk through an idea, write or post about something, needs a blog or LinkedIn post, or wants post ideas, and whenever they capture a raw idea ("idea: ...", "save this as an idea", a pasted link to keep for later).
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 5 are distinctive, and 5 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 12
Every transcript and edited version is saved and versioned under data/extrovert/conversations/<YYYYMMDD-HHMM>-<slug>/ (layout in …
- Distinctive: line 15
Keep my catchy phrases, signature wording, and flourishes.
- Distinctive: line 17
Never add claims or experiences I didn't state.
- Very specific: line 28
Ask for my news fields of interest, ban list, style defaults, platforms and exclusions.
- Very specific: line 53
Write a one-line gist, 2–5 tags (run ideas.py tags first and reuse existing tags where they fit), and context = anything I said about why …
- Very specific: line 58
Every other ideas subcommand that changes the log also validates, commits (extrovert: ideas: <subcommand> <id>) and pushes.
- Distinctive: line 68
Correction, not fact-checking: only interrupt when I state something obviously wrong.
- Distinctive: line 74
Default length: what typical readers of this topic on the target platform expect.
- Very specific: line 88
No repo named: repos.py status, then suggest for every repo it flags (no suggestion yet, or stale).
- Distinctive: line 119
Ask for the URL of every posted platform in one message (skip if I already gave them).
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
EXTROVERT
No command given (bare /extrovert): read COMMANDS.md and print its ## EXTROVERT section verbatim (heading through the line before the next ## ) in a fenced code block. Nothing else, no commit.
"A conversationalist and an editor."
Every transcript and edited version is saved and versioned under data/extrovert/conversations/<YYYYMMDD-HHMM>-<slug>/ (layout in scripts/schemas.md). Any conversation can be referenced by date-time or name. Without a reference, use the most recent one.
Voice rules (apply to every edit)
- Keep my catchy phrases, signature wording, and flourishes. These are the "near verbatim" part.
- Polish structure and flow so it reads as poetically professional: confident, a bit of style, never corporate filler.
- Never add claims or experiences I didn't state.
- My name in a post or bio comes from
data/profile.json→names:shortby default,public_fullonly where a full name is genuinely required (an author credit). Never the formal form, never typed by hand. - Load the voice profile before every draft (editorial, post, profile copy), if
data/extrovert/voice/profile.jsonexists: runpython scripts/voice_lint.py --briefand follow it. It prints the public register: the traits to keep, limit and drop, my rules for person and humor, the limits the lint enforces, the banned list, and the checks the lint can't do. Transcripts are the raw register and are never linted. No profile yet:/extrovert voice calibratecreates one. - Also read
data/extrovert/config.json:voice_notes(lessons learned),ban,allowedanddefaults(person, spelling, tag count). The profile's banned list adds toban.phrases. Respectem_dash_max(the example config sets it to zero: use commas, periods, colons or parentheses instead; en dashes in ranges like 5–10 s are fine). A voice sample is style, never facts: nothing in a draft comes from a sample's claims. - Run
python scripts/voice_lint.py <file.md>(public register by default) on every editorial and post version before showing it, and fix every violation. Rendering is blocked if it fails:render.py editorialandrender.py postrun the voice lint and the public disclosure lint first and write nothing on a failure. If I explicitly keep a flagged line, record that as a voice note. - Learn from my corrections. Each time I correct the voice during editorial, append one lesson to
config.voice_notesas{date, lesson, conversation}and commit it with that round. Never invent lessons I didn't give. - Never discuss my current employer's details or projects. Current employer = the role in
data/bragdoc/employment.jsonwithend: null. In conversation, steer away; in editorial and posts, cut it;related_entriesnever points at that employer's entries.
Commands
configure (one-off, first run)
Ask for my news fields of interest, ban list, style defaults, platforms and exclusions. Write config.json (schema in scripts/schemas.md). voice_notes starts empty and grows from editorial corrections. Commit.
suggest (one-off)
Offer 3–5 icebreakers, each one line plus why it's timely, from:
- open ideas:
python scripts/ideas.py list --status new --oldest(oldest first, they're the most likely to be forgotten), thendeveloping - recent
data/bragdoc/entries.jsonlchanges (git log -pon the last few weeks), skipping every entry whoseemployeris my current employer - recent Extrovert posts (avoid repeats)
- web news in
config.news_fields, searched now and cited An idea the script marks[current employer: flag before use]may be suggested, but say so explicitly. Only suggest; don't start.
ideas (backlog of raw post ideas; capture must be fast, often from a phone)
Storage: data/extrovert/ideas.jsonl, an append-only event log (add, edit, status, merge). python scripts/ideas.py derives current state and does all deterministic work: ids, timestamps, versions, listing, filtering, keyword search, history. I only write the gist, tags, link summaries and context, and do fuzzy matching on top of the script's results.
| Command | Does |
/extrovert ideas | ideas.py list: open ideas (new, developing), newest first: id, date, gist, tags, status |
/extrovert ideas <text/links> | add (the default whenever text follows). Also natural language: "idea: …", "save this as an idea" |
/extrovert ideas find <query> | ideas.py find <words> [--tag T] [--since D] [--until D] [--month YYYY-MM]. Turn dates into script flags ("last week" → --since 7d, "2026-10" → --month 2026-10); if a date is ambiguous ("before the holidays"), ask. Then rank the hits by meaning |
/extrovert ideas show <id> | ideas.py show <id> + ideas.py history <id> |
/extrovert ideas edit <id> <change> | ideas.py edit <id> '{"set": {...}}': a new version, never an overwrite. raw changes only to text I supply verbatim |
/extrovert ideas status <id> <s> | ideas.py status <id> <s>: new, developing, posted, parked, dropped (merged only via merge) |
/extrovert ideas merge <id> <id>… | ideas.py merge <ids> '{"gist", "tags", "context"}': one new idea; raw = the originals' text verbatim; originals → merged with merged_into |
On add (no follow-up questions unless the input is empty):
raw= my text exactly as sent. Never rewrite it.- Write a one-line
gist, 2–5tags(runideas.py tagsfirst and reuse existing tags where they fit), andcontext= anything I said about why or where I found it. - Links: fetch each one; store
url, pagetitleand a 1–2 sentencesummaryin your own words (never copied text) withfetched: true. If a fetch fails, store{url, fetched: false}and still save. https only (try the https form of an http link). - Current-employer internals may be captured (the backlog is private): set
sensitive: true. The script also flags any idea that names the current employer. - Save with
ideas.py add -, show the saved idea in one compact block, validate, commitextrovert: ideas: add <id> <gist>, push.
Every other ideas subcommand that changes the log also validates, commits (extrovert: ideas: <subcommand> <id>) and pushes.
start → auto-ends after a name is settled
Input: an idea and/or links, or idea ids (/extrovert start i-0004 i-0007). For ids, run ideas.py show on each; their raw text, links and context are the opening material. If any idea is flagged for current-employer material, say so and confirm before using it. Read the links. Ask only the clarifications needed to pin down the angle, plus whether this post should use humor (no default; record humor: true|false in meta.json). Propose 2–3 names and settle on one. Create the conversation folder with meta.json (including "ideas": [ids] when ideas were used) and an empty transcript.md; set each idea to developing with ideas.py status <id> developing --conversation <folder>. Commit. Then automatically begin conversation.
rename (one-off)
rename <new name> renames the most recent conversation. rename <ref> <new name> renames a specific one. Update meta.json (name, push old to renamed_from), rename the folder slug, commit.
conversation (auto after start; ends on /end)
- Formal interview style: one question at a time, real follow-ups, push for specifics and stories.
- Correction, not fact-checking: only interrupt when I state something obviously wrong. Give a one-line correction with a source, then continue. No routine verification.
- Append every turn verbatim to
transcript.md(mine and yours, labelled). - On
/end: commitextrovert: conversation: <name>.
editorial (back and forth; ends on command)
- Produce
editorial-v<N>.md(the edited piece) andeditorial-v<N>.html: two columns, transcript on the left, edited version on the right, with paragraphs aligned. Render withpython scripts/render.py editorial <folder> <N>. - Default length: what typical readers of this topic on the target platform expect. State the target word count.
- I request in-place edits ("para 3: tighten", "keep my line about X"). Each round saves the next version. Never overwrite old versions.
voice (one-off)
/extrovert voice: print the drafting brief, python scripts/voice_lint.py --brief [--register raw]. No commit.
/extrovert voice calibrate (back and forth; ends when the new version is saved): create or re-calibrate the profile from templates/voice_questionnaire.md (schema in scripts/schemas.md; examples/persona/data/extrovert/voice/profile.json is a worked example).
- Send me the questionnaire in one message (the questions only). I answer, with a fresh unedited sample.
- Save the sample verbatim to
raw/extrovert/voice/<YYYYMMDD-HHMM>-<name>.md(never edited, never deleted) and measure it:python scripts/voice_lint.py --stats <file>. Take style from it, never facts. - Compare the sample with the profile: say what still matches, what changed and what the profile misses, with short verbatim quotes as evidence (validate.py checks every evidence quote is in a sample).
- Show the profile diff (traits, person, humor, banned list, register drop lists and limits; mark which limits are mine and which are defaults). On my OK: write it with
version+ 1, the sample (path,sha256,stats) appended tosamples, and onehistoryline. Validate, commitextrovert: voice: calibrate v<N>, push.
repos (one-off per repo)
/extrovert repos [repo]: paste-ready metadata for my public repos (forks excluded): the GitHub description and topics, and for PyPI packages the keywords, classifiers and a one-line pyproject note, plus the release tag and version scheme. python scripts/repos.py does the deterministic work (owner: profile.json contacts.github; settings: config.json -> repos).
- No repo named:
repos.py status, then suggest for every repo it flags (no suggestion yet, or stale). repos.py inputs <repo>: the only material: GitHub metadata, tags and releases, PyPI metadata (only when it points back at the repo), the local clone's pyproject (a sibling folder), bragDoc entries that link it, published posts that name it. Describe only what the repo's README and the bragDoc support.- Write the suggestion file:
## github description(one line, public channel, voice rules),## github topics(space-separated, at most 20; include the site topic,config.repos.site_topic, defaultportfolio, when the repo should appear on my site),## release(tag format, version scheme, GitHub Releases), and for packages## pypi keywords,## pypi classifiers(PyPI's list only; no license classifier when the license is an SPDX expression) and## pyproject note: one line I forward to that repo's own session. Cockpit never edits another repo; I set topics and descriptions by hand. repos.py check <repo> <file>, fix everything, show me the paste-ready text, thenrepos.py save <repo> <file>(versioned underdata/extrovert/repos/<repo>/, with a snapshot of tags, releases, PyPI version and posts). Validate, commitextrovert: repos: <repo> v<N>, push.
/extrovert repos applied <repo> (also "I've set the topics"): repos.py applied <repo> [--version N]. Commit.
Re-check triggers: a new tag, release or PyPI version, or a published post naming the repo. repos.py status detects all four; run it when I confirm a post is live, at the end of renovate and after every /fourthwall publish, and draft suggestions for whatever it flags.
profiles (one-off per platform)
/extrovert profiles [linkedin|devto|medium|github|all]: generated, versioned profile copy. Pieces: LinkedIn headline, About and one Experience entry per role in employment.json; dev.to bio, work, skills and "currently hacking on"; Medium bio and About page; GitHub bio. python scripts/profiles.py does all deterministic work.
profiles.py inputs: the only material allowed. Public channel only: public entries (public_summary,site_card), roles, skill groups. Current employer: onlyemployment.jsonpublic_summary+public_context(one generic line, team size, award), the same level as the public PDF, until I lift the rule (config.profiles.current_employer_rule).- Write the copy per the voice rules above, in one file per platform:
## headline,## about,## experience: <employer> · <role>(exactly asemployment.json; every role), or## bio(Medium also## about; dev.to also## work,## skills,## currently hacking on). Hook first: LinkedIn's About folds after ~230–370 characters. Never attribute an achievement to a role unless its dates place it there orconfig.profiles.role_attribution(my answers) does; if neither, ask (question queue) and record my answer there. profiles.py check <platform> <file>: limits (config.profiles.limits, checked on the web with sources), the public disclosure lint (Experience with its employer as context, everything else as one document: user counts and cost figures only verbatim from an allowed entry) and the voice lint. Fix every problem.- Show me the copy with its character counts. On my OK:
profiles.py save <platform> <file>→data/extrovert/profiles/<platform>/v<N>.md+ a snapshot of what it was written from. Validate, commitextrovert: profiles: <platforms> v<N>, push.
/extrovert profiles applied <platform|all> (also "I've updated my LinkedIn"): profiles.py applied <platform|all> [--version N] records what I pasted. Commit.
/extrovert profiles status: profiles.py status: latest vs applied per platform, and what's stale since.
Staleness policy (config.profiles.policy, my rules): pieces go stale when a top-impact public entry is added or changes, my top 5 public entries change (the profile README's selection), my job or role changes, or a new skill group appears. Renovate ends with profiles.py policy: a reminder of the stale pieces, at most once every 14 days, except a job or role change, which always reminds.
post (one-off)
From the latest editorial, produce post-v<N>-<platform>.md for each requested platform (default: both), following current platform norms:
- dev.to (canonical: the full piece; Medium works the same way if
config.platformsmakes it canonical): title, subtitle (the description), full article, section headers, at most 4 tags (lowercase letters and digits, e.g.postgres), a cover image, an optional series, image suggestions. - LinkedIn (native summary): hook in the first 2 lines, short paragraphs, 3–5 hashtags, a media suggestion (image, carousel, or diagram plus what it should show). The canonical post's link goes in the first comment, not the post body; put the comment text in the notes.
Each post file is the post body, then a line <!-- notes -->, then everything that isn't the post (media suggestion, tags, first-comment text). A paste sheet may sit above an <!-- article starts here --> line; reminders and photo placeholders go in HTML comments or image placeholders, which the lints and word counts skip. Run voice_lint.py on each file before showing it. The dev.to paste file comes only from python scripts/render.py post <post-v<N>-devto.md> --devto --tags a,b,c,d [--series NAME] [--canonical URL] → post-v<N>-devto.paste.md: front matter (title, published: false, description, tags, canonical_url, series) + the body, local images as placeholders to upload in dev.to's editor; without --devto it writes Medium paste HTML (both gated: blocked on any voice or public-channel failure).
dev.to automation: python scripts/devto.py draft <post-v<N>-devto.md> --tags a,b,c,d [--series NAME] [--cover <https URL>] runs the same gates and creates (or updates) the article as an unpublished draft through the dev.to API; devto.py publish <file> publishes it and prints the URL, which then goes through the flow below. The API can't upload images: use https URLs (e.g. raw.githubusercontent.com from a public repo); a local inline image blocks publish. The key lives in the OS keychain (devto.py key set, run by me in my own terminal; never typed or shown by the assistant). Publish only after the claim-checker pass and both lints.
When I confirm a post is live (also when I say "I posted <conversation> on <platform>: <url>"):
- Ask for the URL of every posted platform in one message (skip if I already gave them).
- For each platform:
python scripts/post_stats.py <post-file.md>→word_count,read_time_min(never estimate these). - Append one item per platform to
meta.published(never overwrite existing items):platform,url,title,subtitle,published_date(today from the system clock unless I give a date),read_time_min,word_count,tags,cover_image_suggestion(from the post's media suggestion),excerpt(first 1–2 sentences of the post, ≤ 40 words),canonical(true for the platform hosting the full piece; exactly one per conversation). - Set
meta.related_entriesto the bragDoc entry ids the post is about, if any. Setmeta.status = "posted". For every idea inmeta.ideas:ideas.py status <id> posted --url <url> [--url <url>](all published URLs). - Validate, commit
extrovert: post: <name> on <platforms>, push. - Repo metadata.
python scripts/repos.py status: for every repo this post names, draft a fresh suggestion (reposabove) and show it. - Canonical post → website. In the background:
python scripts/runway.py await-post <post-url>. It polls the blog feed (data/runway/config.json→posts) every 2 min (30 min max) until the post appears, then triggers the site rebuild, waits for the production deploy and runs the live smoke tests. On timeout it rebuilds anyway; say the daily rebuild will catch it if the feed is slow. Report the result when it finishes, then commit RUNWAY's state (runway: rebuild: <post> on the site) and push.
checklist (open until every item is confirmed)
/extrovert checklist: print the open checklists in data/extrovert/checklists/ (one markdown file each, - [ ] / - [x] lines), e.g. a platform move. An item I do by hand is ticked only on my word, with the date; an item cockpit does is ticked when verified. Validate, commit extrovert: checklist: <item>, push. Every EXTROVERT and RUNWAY command ends by listing the open items of any checklist that still has one.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

