blog-draft by luongnv89/skills

User Input

$ARGUMENTS

User should provide:

Topic: The main concept or theme
Resources: URLs, files, or references (optional)
Audience/Tone: Who it's for and style preference (optional)

For existing posts: If updating an existing draft, skip to the Iteration section.

Workflow

1. Setup & Research

Create project folder: blog-posts/YYYY-MM-DD-topic-slug/
For each resource, fetch/read and save summaries to resources/source-N-name.md
Add/update blog-posts/status.json entry for this slug:
- status: draft
- public_url: empty string
- title: working title
Present research summary to user

2. Brainstorm & Clarify

Present findings and ask:

Main takeaway for readers?
Target length? (short: 500-800, medium: 1000-1500, long: 2000+)
Points to emphasize or exclude?

Wait for user response.

3. Title & Outline

Generate SEO-Optimized Title

Follow references/seo-title-guide.md to create click-worthy titles:

Identify primary keyword from topic
Generate 5 title options using these patterns:
- Keyword + Benefit: "SEO Title Tags: Master Optimization in 5 Steps"
- Number + Keyword + Outcome: "7 Proven Tips to Boost Your Blog Traffic"
- How to + Keyword + Outcome: "How to Write Headlines That Get Clicks"
- Keyword + Audience + Year: "React Hooks for Beginners (2026 Guide)"
Validate: 45-65 characters, keyword near start, specific benefit included
Present options to user for selection

Create Outline

Include:

Selected title and 2-3 alternates for A/B testing
Meta info (audience, tone, length, main takeaway, primary keyword)
Section structure with key points and supporting evidence
Sources to cite

Get user approval, then save as OUTLINE.md and commit.

4. Draft

Write the full post following the outline. Use assets/draft-template.md for structure.

Citation requirement: Every statistic, comparison, or factual claim must cite its source using inline references [1] linked to a References section.

Save as draft-v0.1.md and commit.

5. SEO Content Optimization

Before review, optimize content for search engines. See references/seo-content-guide.md for details.

Checklist

Save SEO-optimized version and commit.

6. Review, Status, and Iterate

Present draft and ask for feedback on:

Overall impression
Sections needing changes
Tone adjustments
Missing information

If changes requested:

Increment version (v0.2, v0.3...), incorporate feedback, repeat review.

If paused/not publishing now:

Set status to on-hold in blog-posts/status.json.

If approved and published:

Set status to complete in blog-posts/status.json.
Set public_url to final published blog URL.

If still in progress:

Keep status draft.

7. Sync Blog Tracker README (mandatory)

After any draft creation, status change, or publish URL update, run from the blogs/ repo root:

python3 scripts/update_blog_drafts_readme.py

This updates blogs/README.md to list all blog drafts with:

created date
link to latest draft (or outline)
status (draft, complete, on-hold)
public blog link for completed posts

8. Report with GitHub links (mandatory)

When reporting any blog draft result, include:

GitHub link(s) to created/updated draft files (OUTLINE.md, draft-v*.md, status.json, README.md if changed)
Commit hash

Link format:

https://github.com/luongnv89/blogs/blob/main/<relative-path>

Output Structure

blog-posts/
├── status.json
├── YYYY-MM-DD-topic-name/
│   ├── resources/
│   │   ├── source-1-name.md
│   │   └── source-2-name.md
│   ├── OUTLINE.md
│   ├── draft-v0.1.md
│   └── draft-v0.2.md (if iterated)
README.md

Resources

references/seo-title-guide.md - SEO title optimization patterns and checklist
references/seo-content-guide.md - SEO content optimization (keywords, meta, links, readability)
assets/draft-template.md - Blog post structure template
assets/outline-template.md - Outline structure template