MCPInstall

article

Generate technical articles and documentation using AI. Use for writing blog posts, documentation, and technical content.

Installs
49
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/johnlindquist/claude --skill article
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads article automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Article Generator

Create technical articles and documentation with AI assistance.

Prerequisites

# Claude CLI for article generation
npm install -g @anthropic-ai/claude-cli
export ANTHROPIC_API_KEY=your_api_key

# Or Gemini as alternative
pip install google-generativeai
export GEMINI_API_KEY=your_api_key

Article Operations

Generate Article

claude --print --model opus "Write a technical article about: [topic]

Requirements:
- Target audience: [developers/beginners/etc]
- Length: ~[1500] words
- Include code examples
- Practical focus

Structure:
1. Hook/intro that establishes the problem
2. Context/background
3. Main content with examples
4. Best practices
5. Conclusion with next steps"

Quick Draft

gemini -m pro -o text -e "" "Write a first draft article about: [topic]

Keep it concise (~800 words) with:
- Clear thesis
- 3-4 main points
- One code example
- Actionable takeaway"

Expand Outline

gemini -m pro -o text -e "" "Expand this outline into a full article:

OUTLINE:
1. [Point 1]
2. [Point 2]
3. [Point 3]

For each section, provide:
- 2-3 paragraphs
- Relevant examples
- Transitions between sections"

Article Types

Tutorial

claude --print --model opus "Write a step-by-step tutorial for: [task]

Format:
- Prerequisites section
- Numbered steps with code
- Expected output at each step
- Common errors and fixes
- Complete working example at end"

Comparison Article

gemini -m pro -o text -e "" "Write a comparison article:

COMPARING: [Option A] vs [Option B]
CONTEXT: [Use case]

Include:
- Overview of each
- Feature comparison table
- Code examples for each
- When to use which
- Clear recommendation"

Explainer

gemini -m pro -o text -e "" "Write an explainer article about: [concept]

Audience: [technical level]

Cover:
- What it is (simple definition)
- Why it matters
- How it works (with diagrams if helpful)
- Real-world examples
- Common misconceptions"

How We Built It

gemini -m pro -o text -e "" "Write a 'how we built it' article based on:

PROJECT: [description]
TECH STACK: [technologies]
CHALLENGES: [key challenges faced]
SOLUTIONS: [how you solved them]

Format as engineering blog post with:
- Problem statement
- Architecture decisions
- Implementation details
- Lessons learned
- Results/metrics"

Content Enhancement

Verify Technical Accuracy

ARTICLE=$(cat draft.md)
gemini -m pro -o text -e "" "Review this technical article for accuracy:

$ARTICLE

Check:
1. Code examples work correctly
2. Technical claims are accurate
3. Best practices are current
4. No outdated information
5. Security considerations

Flag any issues with corrections."

Improve Readability

ARTICLE=$(cat draft.md)
gemini -m pro -o text -e "" "Improve the readability of this article:

$ARTICLE

Focus on:
- Clearer sentences
- Better transitions
- Active voice
- Removing jargon
- Adding helpful examples"

Add Code Examples

ARTICLE=$(cat draft.md)
gemini -m pro -o text -e "" "Add practical code examples to this article:

$ARTICLE

For each concept:
- Add working code snippet
- Include comments
- Show expected output
- Provide variations where helpful"

Generate Revision

ARTICLE=$(cat draft.md)
FEEDBACK="[feedback from reviewers]"

gemini -m pro -o text -e "" "Revise this article based on feedback:

CURRENT:
$ARTICLE

FEEDBACK:
$FEEDBACK

Incorporate the feedback while maintaining the article's voice and structure."

Structure Templates

Blog Post Template

# [Catchy Title]

[1-2 sentence hook that identifies the problem]

## The Problem

[Describe the pain point readers face]

## The Solution

[Introduce your approach]

### [Key Point 1]

[Explanation with code example]

### [Key Point 2]

[Explanation with code example]

## Putting It Together

[Complete example combining the concepts]

## Conclusion

[Summary and call to action]

Tutorial Template

# How to [Do Something]

## Prerequisites

- [Requirement 1]
- [Requirement 2]

## What We're Building

[Brief description and screenshot/diagram]

## Step 1: [First Step]

[Instructions]

```code
[Example]

Step 2: [Second Step]

...

Complete Code

[Full working example]

Next Steps

[Where to go from here]


## Best Practices

1. **Start with the reader** - What problem do they have?
2. **Show, don't tell** - Use code examples
3. **One idea per section** - Keep it focused
4. **Use concrete examples** - Abstract concepts need grounding
5. **Include working code** - Test everything
6. **End with action** - Tell readers what to do next
7. **Get feedback** - Have someone else read it
8. **Revise ruthlessly** - First drafts are just the start

FAQ

What does the article skill do?

Generate technical articles and documentation using AI. Use for writing blog posts, documentation, and technical content.

How do I install article?

Run npx skills add https://github.com/johnlindquist/claude --skill article in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/article/ (personal) or .claude/skills/article/ (project).

Which AI agents can use article?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is article safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains article?

It is published by johnlindquist in johnlindquist/claude. It has 49 recorded installs.

More from johnlindquist/claude

View all →

gemini-image

johnlindquist/claude

Analyze images using Gemini's vision capabilities. Use for image analysis, text extraction from screenshots, and visual content understanding.

Media & Creative1.2K installs

memory

johnlindquist/claude

Open the skill to read its SKILL.md instructions.

362 installs

raycast-extension

johnlindquist/claude

Open the skill to read its SKILL.md instructions.

321 installs

brainstorm

johnlindquist/claude

Open the skill to read its SKILL.md instructions.

deepwiki

johnlindquist/claude

Open the skill to read its SKILL.md instructions.

269 installs

think

johnlindquist/claude

Open the skill to read its SKILL.md instructions.

258 installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs