Files
claude-engineering-plugin/plugins/compound-engineering/skills/ce-john-voice/SKILL.md
John Lamb 5d4377338e
Some checks failed
CI / pr-title (push) Has been cancelled
CI / test (push) Has been cancelled
Release PR / release-pr (push) Has been cancelled
Release PR / publish-cli (push) Has been cancelled
Merge step (c): converge to ce-* convention for agents and skills
Aligns local custom agents, skills, and modified shared agents with upstream's
flat ce-<name>.agent.md + ce-<skill>/ convention introduced in upstream v3.x.

Changes:
- Delete 9 upstream-renamed agents for locally-dropped agents (design/*, rails
  reviewers, ankane-readme-writer, data-migration-expert, performance-oracle,
  security-sentinel)
- Delete ce-dhh-rails-style skill (local dropped dhh-rails-style entirely)
- Move 5 custom agents to flat ce-<name>.agent.md paths:
  * python-package-readme-writer, design-conformance-reviewer,
    tiangolo-fastapi-reviewer, zip-agent-validator, lint
- Rename 12 custom skill directories with ce- prefix:
  * john-voice, jira-ticket-writer, hugo-blog-publisher, weekly-shipped,
    proof-push, ship-it, story-lens, sync-confluence, excalidraw-png-export,
    python-package-writer, fastapi-style, upstream-merge
- Port local Python/FastAPI edits into upstream's flat ce-best-practices-
  researcher.agent.md and ce-kieran-python-reviewer.agent.md
- Update frontmatter name: fields in all 17 renamed files to match new paths

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 12:53:31 -05:00

2.2 KiB

name, description, allowed-tools
name description allowed-tools
ce-john-voice This skill should be used whenever writing content that should sound like John Lamb wrote it. It applies to all written output including Slack messages, emails, Jira tickets, technical docs, prose, blog posts, cover letters, and any other communication. This skill provides John's authentic writing voice, tone, and style patterns organized by venue and audience. Other skills should invoke this skill when producing written content on John's behalf. Triggers on any content generation, drafting, or editing task where the output represents John's voice. Read

John's Writing Voice

This skill captures John Lamb's authentic writing voice for use across all written content. It is a reference skill designed to be called by other skills or used directly whenever producing text that should sound like John wrote it.

How to Use This Skill

  1. Determine the venue and audience for the content being produced
  2. Load references/core-voice.md — this always applies regardless of context
  3. Load the appropriate venue-specific tone guide from references/:
    • Prose, essays, blog postsreferences/prose-essays.md
    • Slack messages, quick emails, casual commsreferences/casual-messages.md
    • Technical docs, Jira tickets, PRs, code reviewsreferences/professional-technical.md
    • Cover letters, LinkedIn, formal professionalreferences/formal-professional.md
    • Personal reflection, journal, notesreferences/personal-reflection.md
  4. For prose and essays, also load references/signature-moves.md — these are the techniques that make the writing move
  5. Apply both the core voice and the venue-specific guide when drafting content
  6. Before finishing, run references/revision-checklist.md — if any item flags, rewrite before delivering

Key Principle

John prizes simplicity and clarity above all else. He writes to convey meaning, not to sound smart. If the output uses words John wouldn't say aloud to a friend, it's wrong. If it obscures meaning behind fancy language, it's wrong. If it sounds like a corporate press release or a ChatGPT default (NO emdashes!), it's catastrophically wrong.