Skip to content
headline-crafter logo

Headline Crafter

headline-crafter

Generate authentic, compelling article headlines using composable keyword extraction and pattern-based title generation.

SKILL.md

Full skill instructions

Headline Crafter

Composable scripts for generating article headlines from ideas or drafts. Extract keywords, apply proven title patterns, and format the output.

Purpose

Headlines make or break content. This skill extracts key topics from your input, applies curated title formulas across styles (professional, casual, provocative, how-to), and outputs formatted results. Each script is independently usable in a pipeline.

Scripts Overview

ScriptDescription
scripts/​run.shMain pipeline — extract
scripts/​extract.shExtract keywords from text input
scripts/​generate.shGenerate titles from comma-separated keywords
scripts/​format.shFormat title output as numbered list, JSON, or plain
scripts/​test.shRun the full test suite

Pipeline Examples

# Generate 5 headlines from an article idea
echo "How to deploy machine learning models in production" | ./​scripts/​run.sh

# Extract keywords, then generate with a specific style
echo "The future of remote work" | ./​scripts/​extract.sh | ./​scripts/​generate.sh --style professional --count 8

# Generate and format as JSON
echo "react,hooks,state,management" | ./​scripts/​generate.sh --count 5 | ./​scripts/​format.sh --format json

# Full pipeline with custom count
cat article-draft.md | ./​scripts/​run.sh --count 10 --style casual

Inputs and Outputs

  • extract.sh: text via stdin → comma-separated keywords to stdout
  • generate.sh: comma-separated keywords via stdin → one title per line to stdout
  • format.sh: one title per line via stdin → formatted output to stdout
  • run.sh: text via stdin → formatted titles to stdout (orchestrates the pipeline)

Environment Variables

VariableDefaultDescription
HEADLINE_STYLEmixedDefault title style
HEADLINE_COUNT5Default number of titles