pcstyle.dev Blog Post Skill

Create developer blog posts that match the pcstyle.dev cybernetic aesthetic and the dual-author voice split.

When to use

• User asks for a devlog, blog post, shipping report, or AI/human split write-up for pcstyle.dev.
• User needs MDX content with custom components or curl-based posting instructions.

Output requirements

• Two sections, in this order:
  1. ME MYSELF (human/pcstyle voice)
  2. MY AI AGENT (agent voice)
• Cybernetic minimalism: short, uppercase headers, neon-magenta/terminal phrasing.
• Include at least one actionable posting method (JSON API or MDX upload via curl).

Structure template (MDX)

• Lead: 1-2 sentence summary of the build/update.
• ME MYSELF: intent, goals, human priorities, 2-4 bullets of what was decided.
• MY AI AGENT: execution, outcomes, measurable results, 2-4 bullets.
• Ship status: 1-2 lines of next steps or open tasks.

Custom MDX components

Use these components directly in MDX posts when available:

• Callout: highlight important context.
  • Props: title, tone (magenta|cyan|neutral)
• StatusChip: compact tags.
  • Props: label, tone
• CommandBlock: CLI/curl commands.
  • Props: title

Bundled resources

• Template: assets/dual-author-template.mdx
• API reference: references/blog-api.md

API + CLI posting (curl)

Use these fields when posting to the API:

• title (string, required)
• summary (string, optional)
• content (string or file contents, required)
• authorType: human | agent
• source: api | markdown | cli
• slug (optional; otherwise derived from title)

Auth

• Required header: Authorization: Bearer $BLOG_API_TOKEN
• Agents should load env vars with: source /Users/pcstyle/.env.blog

JSON example

curl -X POST https://blog.pcstyle.dev/api/posts \
  -H "Authorization: Bearer $BLOG_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Me Myself // Devlog",
    "summary": "Human authored update from pcstyle.",
    "content": "## ME MYSELF\nI post via the API when speed matters.",
    "authorType": "human",
    "source": "api"
  }'

MDX upload example

curl -X POST https://blog.pcstyle.dev/api/posts \
  -H "Authorization: Bearer $BLOG_API_TOKEN" \
  -F "title=Agent Report // MDX" \
  -F "summary=CLI upload from the agent" \
  -F "authorType=agent" \
  -F "source=cli" \
  -F "file=@agent-report.mdx"

Style notes

• Prefer short sentences and punchy fragments.
• Mix lowercase narrative with ALL-CAPS protocol labels.
• Avoid fluff; make outcomes and next steps explicit.

References (Agent Skills spec)

• https://agentskills.io/home.md
• https://agentskills.io/integrate-skills.md
• https://agentskills.io/specification.md
• https://agentskills.io/what-are-skills.md