Magic Quill

A magical quill that inscribes themed spell mappings for OpenClaw Spellbook with high coverage for popular skills.

Inputs

• --topic or --url (primary inputs; spell-list lookup searches by topic/theme first, and --url is treated as a high-priority reference candidate when provided)
• Optional --theme to override the final theme name (or run heuristic-only mode with just --theme)
• Optional --out (alias: --output) (default: spells/.yaml)
• Optional --limit (alias: --top) for top-N coverage (default: 50)
• Optional --author (default: @magic-quill)

What To Do

• Gather popular skills from both sources when possible:
• skills.sh trending installs
• ClawHub downloads API endpoint
• Merge and de-duplicate the results into a target set (fill gaps from built-in fallback skills if fetch fails).
• Gather spell-list references first (primary spell source):
• Build dynamic web search queries from topic/theme (for example spell list and spells api)
• Parse top search result links (DuckDuckGo HTML results) into candidate reference URLs
• Include --url as a high-priority candidate when present
• Fetch discovered JSON/HTML references (for example dnd5eapi.co if discovered), extract spell names, and merge/de-duplicate names from successful references
• Gather lore/context (secondary style keywords only):
• If --url is provided, fetch and extract page text
• Else if --topic is provided, try Wikipedia summary API
• If fetch fails, use built-in theme lexicon/heuristics
• If spell-list references fail or do not produce enough names, generate spell mappings with the built-in heuristic spell-name generator.
• Write YAML to the requested output path (usually under spells/), including # spell-list-references: comment links for successful dynamically discovered spell-list sources/endpoints when available.
• Validate with npm run validate:spells if the output file is under spells/.

Commands (Users)

npm run generate:spellbook-theme -- --theme "Studio Ghibli" --limit 50 --author "@you"
npm run generate:spellbook-theme -- --topic "Cyberpunk 2077" --limit 75 --out spells/cyberpunk-2077.yaml --author "@you"
npm run generate:spellbook-theme -- --url "https://en.wikipedia.org/wiki/The_Lord_of_the_Rings" --limit 50 --author "@you"
npm run generate:spellbook-theme -- --topic "DnD 5e" --limit 20 --author "@you"

Commands (Agents)

node magic-quill/scripts/generate-spell-mapping.mjs --theme "The Legend of Zelda" --topic "The Legend of Zelda" --limit 50 --out spells/zelda.yaml --author "@example"
node scripts/validate-spells.mjs

Install From This Repo (Subpath)

Use a repo subpath source with npx skills add, for example:

npx skills add wynnsu/openclaw-spellbook/magic-quill

⚠️ Requires Hook for Use

This skill generates spell YAML mapping files — to actually use the themed spells in agent sessions, you need the openclaw-spellbook hook installed. Install the full spellbook package:

# Install the spellbook hook (includes magic-quill skill)
npx skills add wynnsu/openclaw-spellbook

Or install just the hook directly from the repo:

npx skills add wynnsu/openclaw-spellbook/hooks/spellbook

The hook handles the translation between magical spell names and actual skill IDs at runtime.

Usage after install (example prompt):

Use magic-quill to create a Star Wars spell mapping with top 50 coverage and write it to spells/star-wars.yaml.