headline-crafter

SKILL.md

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

Script Description
scripts/run.sh Main pipeline — extract
scripts/extract.sh Extract keywords from text input
scripts/generate.sh Generate titles from comma-separated keywords
scripts/format.sh Format title output as numbered list, JSON, or plain
scripts/test.sh Run 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

Variable Default Description
HEADLINE_STYLE mixed Default title style
HEADLINE_COUNT 5 Default number of titles
Weekly Installs
3
First Seen
Feb 10, 2026
Installed on
amp3
gemini-cli3
github-copilot3
codex3
kimi-cli3
opencode3