content-authoring

zlliang's avatarfrom zlliang

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.

⭐3stars🔀0forks📁View on GitHub🕐Updated Jan 11, 2026

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.
namecontent-authoring
descriptionGuides 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 in content/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

  1. Notes: Create → write → remove draft: true → commit
  2. Posts: Create draft → write/polish → pnpm run ship → commit

For the detailed workflow, see workflow.md.