How do I install the Narrated Poem skill?

Run npx skillmds@latest add nanoodlecom/narrated-poem in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Narrated Poem safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Narrated Poem?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Narrated Poem free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Narrated Poem?

nanoodlecom (@nanoodlecom) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Narrated Poem by nanoodlecom — Agent Skill

Name: Narrated Poem
Author: nanoodlecom

Narrated Poem

Turn a picture into a spoken poem — a vision model describes the image, an LLM writes a short poem from the description, and a text-to-speech model narrates it. Use when the user wants a poem, narration, or spoken-word piece inspired by an image file.

nanoodlecom 1dc7249 2 files · 3.7 KB Updated Sep 17, 2026

File contents

Narrated poem

Runs the bundled nanoodle workflow workflows/narrated-poem.noodle-graph.json against the NanoGPT API: an image input (Picture) feeds a vision model that describes it, an LLM turns the description into a four-line poem, and a TTS model speaks it (Narration). Requires Node.js >= 20 and the nanoodle npm package (npx nanoodle fetches it).

API key

The run needs a NanoGPT API key. Prefer NANOGPT_API_KEY already in the environment. Otherwise pass --env-file <path-to-.env> (this CLI: --env-file overrides ambient env).

Never print the key.

Run

From this skill's directory (or prefix paths if running from elsewhere). @path attaches a local file:

npx nanoodle run workflows/narrated-poem.noodle-graph.json \
  --input "Picture=@/path/to/picture.jpg" \
  --out ./poem-out

Add --env-file .env only when the key is not already exported. Add --json for a structured result (paths, costUsd, remainingBalance).

Optional overrides:

--input "Poet=<custom poet instructions, e.g. write a limerick instead>"
--set "n4.voice=am_michael"        # pick a Kokoro voice (af_bella, am_adam, bf_emma, …)
--set "n2.q=<different question to ask about the image>"

Inspect the interface anytime with:

npx nanoodle inspect workflows/narrated-poem.noodle-graph.json

Inputs

Key	Required	What to pass
`Picture`	yes	`@<path>` to the user's image file (jpg/png/webp)
`Poet`	no	Custom instructions for the poem-writing LLM (its system prompt)

Poet is the node name shown in the editor. It replaces that node's system prompt.

Outputs

Media is saved under --out as Narration.<ext> — extension follows the audio MIME (often mp3 or wav). Use the path the CLI prints on the Narration: line; do not hard-code the extension.
With --json, the path is in outputs.Narration.

Cost

Each run costs about $0.01 in NanoGPT credit (vision + LLM are fractions of a cent; Kokoro-82m speech is ~$0.002 per poem). Runs spend real credit — tell the user before running repeatedly.

---name: narrated-poemdescription: Turn a picture into a spoken poem — a vision model describes the image, an LLM writes a short poem from the description, and a text-to-speech model narrates it. Use when the user wants a poem, narration, or spoken-word piece inspired by an image file.---# Narrated poemRuns the bundled nanoodle workflow `workflows/narrated-poem.noodle-graph.json` against theNanoGPT API: an image input (`Picture`) feeds a vision model that describes it, an LLM turnsthe description into a four-line poem, and a TTS model speaks it (`Narration`). RequiresNode.js >= 20 and the `nanoodle` npm package (`npx nanoodle` fetches it).## API keyThe run needs a NanoGPT API key. Prefer `NANOGPT_API_KEY` already in the environment.Otherwise pass `--env-file <path-to-.env>` (this CLI: `--env-file` overrides ambient env).Never print the key.## RunFrom this skill's directory (or prefix paths if running from elsewhere). `@path` attaches alocal file:```shnpx nanoodle run workflows/narrated-poem.noodle-graph.json \ --input "Picture=@/path/to/picture.jpg" \ --out ./poem-out```Add `--env-file .env` only when the key is not already exported. Add `--json` for astructured result (paths, costUsd, remainingBalance).Optional overrides:```sh--input "Poet=<custom poet instructions, e.g. write a limerick instead>"--set "n4.voice=am_michael" # pick a Kokoro voice (af_bella, am_adam, bf_emma, …)--set "n2.q=<different question to ask about the image>"```Inspect the interface anytime with:```shnpx nanoodle inspect workflows/narrated-poem.noodle-graph.json```## Inputs| Key | Required | What to pass ||-----|----------|--------------|| `Picture` | yes | `@<path>` to the user's image file (jpg/png/webp) || `Poet` | no | Custom instructions for the poem-writing LLM (its system prompt) |`Poet` is the node name shown in the editor. It replaces that node's system prompt.## Outputs- Media is saved under `--out` as `Narration.<ext>` — extension follows the audio MIME (often `mp3` or `wav`). **Use the path the CLI prints on the `Narration:` line**; do not hard-code the extension.- With `--json`, the path is in `outputs.Narration`.## CostEach run costs about **$0.01** in NanoGPT credit (vision + LLM are fractions of a cent;`Kokoro-82m` speech is ~$0.002 per poem). Runs spend real credit — tell the user beforerunning repeatedly.

Frequently asked questions