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>
2.2 KiB
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
- Determine the venue and audience for the content being produced
- Load
references/core-voice.md— this always applies regardless of context - Load the appropriate venue-specific tone guide from
references/:- Prose, essays, blog posts →
references/prose-essays.md - Slack messages, quick emails, casual comms →
references/casual-messages.md - Technical docs, Jira tickets, PRs, code reviews →
references/professional-technical.md - Cover letters, LinkedIn, formal professional →
references/formal-professional.md - Personal reflection, journal, notes →
references/personal-reflection.md
- Prose, essays, blog posts →
- For prose and essays, also load
references/signature-moves.md— these are the techniques that make the writing move - Apply both the core voice and the venue-specific guide when drafting content
- 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.