content-authoring
Guides writing and publishing notes and posts for the `tech` and `days` websites. Use when creating, drafting, editing, or shipping blog content, or when reviewing writing style.
When & Why to Use This Skill
This Claude skill optimizes the content creation lifecycle for technical blogs and documentation sites. It provides comprehensive guidance for drafting, editing, and publishing both short-form notes and long-form posts, ensuring consistency through automated workflows, CLI command integration, and a dedicated style guide.
Use Cases
- Drafting and publishing technical content: Streamline the creation of notes and posts with specific directory structures and automated CLI commands like 'pnpm run tech:new'.
- Style guide enforcement: Proactively review and edit writing style to ensure high-quality, professional content that adheres to established, language-agnostic organizational standards.
- Workflow automation: Manage the end-to-end publishing process from initial draft creation to final shipping and repository commits for multiple web platforms like 'tech' and 'days' sites.
| name | content-authoring |
|---|---|
| description | Guides writing and publishing notes and posts for the `tech` and `days` websites. Use when creating, drafting, editing, or shipping blog content, or when reviewing writing style. |
Content authoring
Currently the tech and days websites share a similar structure. Here are instructions for the content authoring on both sites.
Content types
- Notes: Short-form entries in
content/notes/[year]/[month]/[day]/[slug].md - Posts: Long-form entries in
content/posts/[year]/[month]/[day]/[slug].md(drafts incontent/posts/drafts/)
Commands
From the repository root:
pnpm run tech:new note [--category <category>] [title] # Create note on `tech`
pnpm run tech:new post [title] # Create post draft on `tech`
pnpm run tech:ship # Ship post on `tech`
pnpm run days:new note [--category <category>] [title] # Create note on `days`
pnpm run days:new post [title] # Create post draft on `days`
pnpm run days:ship # Ship post on `days`
Style guide
There's a detailed writing style guide in style-guide.md. This guide is language-agnostic. Use it proactively when reviewing writing style.
Workflow
- Notes: Create → write → remove
draft: true→ commit - Posts: Create draft → write/polish →
pnpm run ship→ commit
For the detailed workflow, see workflow.md.