agentleFS
aman-bhandariaman-bhandari/claude-code-agent-skills-framework/.claude/skills/blog-draft/SKILL.md

blog-drafting

Skill0 starsChanged 7 months agoMITView on GitHub

Generates blog post outlines from exercises and learnings for portfolio building. Triggers on /blog, blog idea, or after significant exercises. Produces structure and key points only -- the student writes the prose. Maintains a running ideas backlog in blog-drafts/ideas.md. Prioritizes topics that demonstrate hireable AI engineering skills.

The file

We split this skill into the rules it gives an agent

5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈5

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every exercise is potential portfolio content.

    line 9
  2. Distinctive:

    After completing significant exercises or topics

    line 14
  3. Distinctive:

    When an insight is worth sharing publicly

    line 15
  4. Distinctive:

    NEVER write the blog post.

    line 63
  5. Distinctive:

    Every outline needs a clear "so what" -- why should anyone read this?

    line 65

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Blog Draft -- Portfolio Content Generator

Every exercise is potential portfolio content. Publishing builds credibility and demonstrates expertise to hiring managers.

Trigger

  • /blog or /blog <topic>
  • After completing significant exercises or topics
  • When an insight is worth sharing publicly

Execution

  1. Identify the story angle (not "I learned X" but "Here's what surprised me about X"):
    • What was non-obvious or counterintuitive?
    • What would help another developer avoid a mistake?
    • What connects to the student's unique background (SaaS production experience + AI systems built by directing Claude)?
  2. Generate outline (NOT the post):
    BLOG DRAFT -- {topic}
    
    Title options:
    1. [option -- specific, not generic]
    2. [option -- includes the "so what"]
    
    Hook: [one sentence that makes a reader care]
    
    Sections:
    1. [section] -- [2-3 sentences on what to cover]
    2. [section]
    3. [section]
    
    Code worth showing:
    - [file:lines] -- why it's interesting
    
    Reader questions to address:
    - [anticipated question]
    
    Call to action: [what should reader do next?]
    
    SEO keywords: [3-5 terms people search for]
  3. Save to blog-drafts/{slug}.md
  4. Update blog-drafts/ideas.md backlog

Unique Story Angles

These are angles unique to this learning journey:

  • "I built production AI systems without writing code. Here's what happened when I learned to write it."
  • SaaS production context applied to AI patterns
  • The gap between directing AI and understanding AI
  • Building a Claude-powered learning system from scratch

Rules

  • NEVER write the blog post. Outlines only.
  • Prioritize topics that demonstrate hireable skills (RAG, agents, production patterns)
  • Every outline needs a clear "so what" -- why should anyone read this?
  • Track all ideas, even ones not ready yet. The backlog compounds.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.