Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
vishalsachdev avatar

Write Article

  • 6 installs
  • 2 repo stars
  • Updated August 1, 2026
  • vishalsachdev/claude-skills

Helps with ai & agent building tasks.

About

write-article is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted development.

  • write-article
  • AI & Agent Building
  • AI-coding skill

Write Article by the numbers

  • 6 all-time installs (skills.sh)
  • +1 installs in the week ending Jul 27, 2026 (Skillselion tracking)
  • Ranked #12,739 of 16,556 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 2, 2026 (Skillselion catalog sync)
npx skills add https://github.com/vishalsachdev/claude-skills --skill write-article

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs6
repo stars2
Last updatedAugust 1, 2026
Repositoryvishalsachdev/claude-skills

What it does

Helps with ai & agent building tasks.

Files

SKILL.mdMarkdownGitHub ↗

Write Article for The Hybrid Builder

Write a newsletter article about our collaboration for https://chatwithgpt.substack.com/s/the-hybrid-builder

Context

  • This publication is explicitly stated as AI-written
  • Article documents our collaboration on: $ARGUMENTS

Before Writing: Find Related Articles

Always check the article archive first. The cache includes all 33+ articles with theme indexing and cross-reference tracking.

Article Cache Commands

# Update cache from sitemap (full archive)
python3 ~/.claude/skills/write-article/scripts/update-cache.py

# Get reference suggestions for your topic
python3 ~/.claude/skills/write-article/scripts/update-cache.py --suggest "your topic here"

# List all cached articles
python3 ~/.claude/skills/write-article/scripts/update-cache.py --list

# Browse by theme
python3 ~/.claude/skills/write-article/scripts/update-cache.py --themes

# Find articles related to a specific article
python3 ~/.claude/skills/write-article/scripts/update-cache.py --related "article-slug"

# Search by keyword
python3 ~/.claude/skills/write-article/scripts/update-cache.py --search "compound engineering"

Reference Workflow

1. Run --suggest "topic" to get ranked candidates with phrasing suggestions 2. Review the theme index to spot thematic connections 3. For top candidates, use WebFetch to read full content if needed 4. Apply natural reference patterns from references/reference-patterns.md

Writing Style & Tone

  • Conversational technical narrative blending storytelling with technical detail
  • First-person collaborative perspective (emphasize the partnership)
  • Enthusiastic, exploratory, and optimistic tone
  • Transparent about challenges, failures, and iterative process
  • High technical specificity with code examples and implementation details
  • Meta-narrative about the AI-human collaboration itself

Structure & Format

  • Narrative-driven with chronological progression
  • Use clear sections with timestamps/development phases
  • Include headers and bullet points for readability
  • Typical length: 1500-2500 words
  • Always include: context, technical details, lessons learned, future implications

Natural Cross-Referencing

Avoid mechanical patterns. See references/reference-patterns.md for natural styles.

Quick reference:

StyleExample
Callback"The compound engineering loop kept surfacing..." (no link needed)
Context-first"When I built X, I discovered... that journey taught me..."
Aside"This approach (which I've been systematizing)..."
Thematic echoName the concept, link becomes supplementary

Themes to watch for: compound-engineering, skills, mcp, teaching, ai-collaboration, context-engineering, automation, research, microsim

Data Sources

  • Read git history and recent commits in current repo
  • Check /articles/chat-sessions/ for exported session data if available
  • Cross-reference conversation context from this session
  • Use aichat search "topic" to find related past sessions if relevant
  • Run `--suggest` for intelligent reference recommendations

Output

  • Create both Markdown (.md) and HTML (.html) versions
  • Store in /articles subfolder at the project root (create if needed)
  • Filename format: YYYY-MM-DD-descriptive-slug
  • HTML version should be publication-ready with basic styling

Cover Images

Generate cover images using Python/PIL:

PlatformDimensionsFilename
LinkedIn1200×628YYYY-MM-DD-cover-image.png
Substack1100×220YYYY-MM-DD-substack-banner.png
Twitter1200×675YYYY-MM-DD-twitter-card.png

Design: Dark slate (#0F172A) background, amber (#FBBF24) accents, left-aligned text, large typography (48-76px titles), decorative nodes on right.

Session Transcript Integration

After writing, ask: "Would you like me to publish this session as a shareable transcript?"

If yes:

First, find the current session file (most recent .jsonl for this project):

# Find the current session file
ls -t ~/.claude/projects/-Users-*-$(basename $(pwd))/*.jsonl 2>/dev/null | head -1

Then export using the json command (works non-interactively, unlike local):

# Use 'json' command with direct file path - works from Claude Code
uvx claude-code-transcripts json <SESSION_FILE.jsonl> --gist 2>&1 | tee /tmp/transcript-output.txt

Note: The local command requires interactive terminal input for session selection. Use json with a direct file path when running from Claude Code or scripts.

Add to article:

## Session Transcript
This article was written during a live collaboration session.
[View the full conversation](GIST_URL) to see how we built this together.

Instructions

1. Get reference suggestions: Run --suggest "topic" for the current topic 2. Gather context: Read git log, relevant files, session exports 3. Outline narrative arc of the collaboration 4. Ask the user about specific aspects to emphasize before writing 5. Write article with technical depth and conversational tone 6. Include natural cross-references (1-3 articles, using patterns from reference guide) 7. Create both .md and .html versions in /articles 8. Preview: open /path/to/article.html 9. Create cover images for all three platforms 10. Session transcript (ask user, add if yes) 11. Final review: Confirm all assets are ready

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.