Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

Content Agent Helpers

20 free AI copywriting and creative tools that run in your terminal. Generate ad copy, hooks, headlines, UGC scripts, image prompts, taglines, colour palettes, font pairings, captions and a 30-day social calendar. Every tool is one file, has zero dependencies, and uses your own API key.

Built by Ammar Imtiaz. MIT licensed.

git clone https://github.com/4mmar1mtiaz/Content-Agent-Helpers.git
cd Content-Agent-Helpers
node tools/ad-copy-generator.js --demo

No API key needed for that. Add one when you want it writing about your own product.


Why these exist

Content tools mostly fail in the same way: they hand you one bland option and call it done. These are built around the opposite habit. Generate at volume first, then judge. Most of these tools return a ranked set rather than a single answer, because the twelfth headline is usually better than the first and you cannot know that until you have seen twelve.

They are also built for people who already know what good looks like. There is no wizard, no onboarding flow, no template gallery. You describe the offer, you get structured output, you edit it.


The 20 tools

Tool What it does The question it answers
ad-copy-generator Paste-ready ads with hook, body, CTA and targeting, per channel Write me a Facebook ad
hook-generator Runs an 8-pass chain to produce dozens of ranked openers What is the hook for this ad?
headline-generator Evaluates headlines for clarity, specificity and the promise they make Are my headlines any good?
ad-angle-finder Labels each messaging angle saturated, contested or unclaimed What angle should my ad take?
ad-compliance-checker Checks copy against Meta, Google and TikTok policy with rewrites Will this ad claim get me banned?
ugc-script-generator Three UGC scripts with beats for creator, camera and on-screen text Write me a UGC script
video-script-generator Two short-form scripts with timed shots Write a 30 second video script
landing-page-copy-generator Full landing page copy, section by section, ready to paste Write my landing page
product-description-generator Ecommerce descriptions built from features and real review language Write a product description
email-sequence-generator A 7-email sequence with merge fields and ordered send days Write a welcome email series
subject-line-generator Subject lines checked for length and spam risk Why do my emails not get opened?
swipe-file-builder Turns real customer phrases into reusable copy lines Give me the words my customers use
image-prompt-generator Four full prompts from one vague idea, with composition and lighting Write me an AI image prompt
video-prompt-generator Cinematic shot chains with keyframe and motion prompts How do I prompt Kling or Veo?
brand-voice-generator Voice and tone rules with a concrete example for each How do I define my brand voice?
tagline-generator 18 to 24 taglines by type, with rationale and risk analysis Come up with a tagline
color-palette-generator Checks a palette for WCAG contrast compliance and reports failures Is my colour palette accessible?
font-pairing-generator Five Google Font pairings with weights and fallback stacks What fonts go together?
social-media-calendar-generator A 30-day content calendar, phased and platform-matched Plan a month of posts for me
caption-generator Platform-optimised captions from a post idea Write a caption for this

Quick start

Requirements: Node.js 18 or newer. That is the whole list. There is no npm install because there is nothing to install.

git clone https://github.com/4mmar1mtiaz/Content-Agent-Helpers.git
cd Content-Agent-Helpers

Try any tool with no key:

node tools/tagline-generator.js --demo

Point it at your own product. Set one key, whichever provider you already use:

export ANTHROPIC_API_KEY=sk-ant-...
# or
export OPENAI_API_KEY=sk-...
# or
export GEMINI_API_KEY=...

Then feed it your brief, three ways:

node tools/ad-copy-generator.js "cold plunge tubs for home gyms, $2400, ships in 5 days"
node tools/ad-copy-generator.js brief.txt
echo "cold plunge tubs for home gyms" | node tools/ad-copy-generator.js -

Get an HTML report you can send to a client:

node tools/social-media-calendar-generator.js "local pilates studio" --html

--help works on every tool. So does --demo.


The tools in detail

Ads and direct response

ad-copy-generator

AI ad copy generator. Produces complete, paste-ready ads for each channel you name: hook, body, call to action and a targeting note. Not fragments you have to assemble, whole ads you can put into Ads Manager.

node tools/ad-copy-generator.js "meal prep service for night shift nurses"

hook-generator

Hook generator for ads. Runs an eight-pass chain over your offer and returns dozens of openers, ranked. Hooks are a volume game and this is built like one. Pass one gives you the obvious angles, pass six starts giving you the ones nobody in your niche is running.

headline-generator

AI headline generator. Scores headlines on clarity, specificity, and whether the promise they make is one the product can keep. Feed it your existing headlines to find out which are doing nothing, or feed it an offer to get new ones.

ad-angle-finder

Ad angle ideas. Maps the messaging angles available in a market and labels each one saturated, contested or unclaimed. Running your ad on a saturated angle is the most common reason good creative underperforms.

ad-compliance-checker

Ad copy compliance check. Hard-fails banned claims and flags the weak or risky ones before anything ships, checked against Meta, Google and TikTok policy. Comes back with rewrites, not just rejections.

node tools/ad-compliance-checker.js "Lose 30lbs in 30 days, guaranteed, doctors hate this"

Video and creator content

ugc-script-generator

UGC script generator. Three scripts built on the three-channel rule: what the creator says, what the camera shows, and what appears as on-screen text. Most UGC scripts fail because they only write the first channel.

video-script-generator

AI video script generator. Two full short-form scripts with timed shots, so you know the clip count and length before you book anything.

Web and email copy

landing-page-copy-generator

Landing page copy generator. Section by section: headline, subhead, body, proof, call to action. Structured so you can paste it straight into a site builder without rewriting the hierarchy.

product-description-generator

Product description generator. Writes ecommerce descriptions from your feature list plus the language real reviewers use. The second input is the one that makes the difference.

email-sequence-generator

Email sequence generator. A full 7-email nurture or pre-launch sequence with merge fields and the send day for each. Copy it into your ESP and set the delays.

subject-line-generator

Email subject line generator. Generates subject lines with preview text and checks each for length and spam risk. Open rates die on subject lines long before they die on body copy.

swipe-file-builder

Copywriting swipe file. Extracts the phrases customers actually use from reviews and forum posts and turns them into reusable copy lines. Your best headline is usually already written, by a customer, in a review.

AI image and video prompts

image-prompt-generator

AI image prompt generator. Turns a vague idea into four complete prompts, each with subject, composition, lighting, style and aspect ratio. Works for Midjourney, Seedream, Flux, or whatever you are running.

node tools/image-prompt-generator.js "hero shot for a premium coffee brand"

video-prompt-generator

AI video prompt generator. Builds three cinematic shot chains, each with a still keyframe prompt and a matching motion prompt, for image-to-video models like Kling, Veo and Runway. The keyframe-then-motion split is what separates usable clips from slop.

Brand and design

brand-voice-generator

Brand voice guidelines. Produces voice and tone rules with a concrete right and wrong example for each. Rules without examples are how brand guidelines end up ignored.

tagline-generator

Free slogan generator. Returns 18 to 24 taglines grouped by type, each with a word count, the rationale behind it, and a note on how it could be misread. Volume plus judgement, in one pass.

color-palette-generator

Brand colour palette checker. Takes a palette and evaluates it for WCAG contrast compliance, then reports exactly which combinations fail and by how much. The palette that looks great in Figma is often the one that fails accessibility on the live site.

font-pairing-generator

Font pairing generator. Five Google Font display and body pairings matched to a brand direction, with the weights to use and a fallback stack for each. Copy-paste ready.

Social

social-media-calendar-generator

Social media content calendar. A 30-day calendar built from your business description, phased across the month and matched to the platform. Removes the blank-calendar problem, which is the actual reason most accounts go quiet.

caption-generator

Instagram caption generator. Full captions plus hashtags, written for the platform you name. Handles the fact that a caption that works on LinkedIn dies on Instagram.


How they work

Every tool in this repo follows the same contract:

  • One file. Copy a single .js out of tools/ and it still runs anywhere. Nothing here imports anything else here.
  • Zero dependencies. Node built-ins only. No node_modules folder, no install step, no supply chain to worry about.
  • Bring your own key. Anthropic, OpenAI or Google. Set one environment variable and the tool finds it. Your briefs go to the provider you chose and nowhere else.
  • Demo mode. --demo runs on hand-written sample data with no key and no network call, so you can see the output shape before committing.
  • HTML reports. --html writes a self-contained report. Send it to a client without asking them to install anything.
  • Honest degradation. Tools that want live web search say so at runtime when the provider does not offer it, instead of quietly inventing sources.

FAQ

Are these free? Yes. MIT licensed, no signup, no seat pricing, no credits. You pay your model provider for tokens, which for most of these runs is a fraction of a cent.

Do I need an API key? Not to try them. Every tool ships with --demo, which runs on built-in sample data with no key and no network call. A key is only needed to point a tool at your own product.

Which model provider works best? Any of the three. The tools read ANTHROPIC_API_KEY, OPENAI_API_KEY or GEMINI_API_KEY and use the first one they find. Copy quality tracks the model you pick more than the tool, so use the best model you have access to.

Can I use the output commercially? Yes. MIT license on the tools, and the output is yours. Use it in client work, in your own ads, anywhere.

Will the ad compliance checker keep my account safe? It catches the known hard-fails and the common risky patterns across Meta, Google and TikTok policy. It is a first pass that removes obvious problems, not a legal review, and platform enforcement changes without notice.

Does the colour palette tool pick colours for me? It evaluates a palette you give it against WCAG contrast requirements and tells you which pairings fail. Use it to check a direction before you build the whole design system on top of it.

Why command line instead of a web app? A web app means my server, my rate limits and my pricing page between you and the output. A single file on your machine means none of those exist, and the tool still runs in five years whether or not I am maintaining it.

Can I use these inside my own scripts? Yes, that is the point of the stdin support. Pipe into any tool with - and pipe the output onward. They compose.


Contributing

Issues and pull requests welcome. If a tool gives you weak output, open an issue with the exact input and I will look at the prompt. If you build a twenty-first tool that follows the same one-file zero-dependency contract, send it.


More tools


About

Built by Ammar Imtiaz, who builds software for government contracting, SEO and marketing automation.

Found one of these useful? Star the repo so the next person finds it too.

MIT License. Do what you like with it.

About

20 free AI copywriting and creative tools for your terminal: ad copy generator, hook generator, UGC scripts, AI image and video prompts, tagline generator, colour palette checker, font pairings and a 30-day social calendar. One file each, zero dependencies.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages