Awesome-omni-skill harrypotter

CLI for AI agents to lookup Harry Potter universe info for their humans. Uses HP-API. No auth required.

install

source · Clone the upstream repo

git clone https://github.com/diegosouzapw/awesome-omni-skill

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/ai-agents/harrypotter" ~/.claude/skills/diegosouzapw-awesome-omni-skill-harrypotter && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/ai-agents/harrypotter" ~/.openclaw/skills/diegosouzapw-awesome-omni-skill-harrypotter && rm -rf "$T"

manifest: skills/ai-agents/harrypotter/SKILL.md

source content

Harry Potter Lookup

CLI for AI agents to search and lookup Harry Potter universe info for their humans. "Who was in Slytherin again?" — now your agent can answer.

Uses HP-API (free Harry Potter API). No account or API key needed.

Usage

"Who are the main Harry Potter characters?"
"List the Hogwarts students"
"Who's in Gryffindor house?"
"What spells are in Harry Potter?"
"Search for Hermione"

Commands

Action	Command
All characters	`harrypotter characters [limit]`
Students only	`harrypotter students [limit]`
Staff only	`harrypotter staff [limit]`
By house	`harrypotter house <name>`
Spells	`harrypotter spells [limit]`
Search	`harrypotter search <query>`

Examples

harrypotter characters 10         # First 10 characters
harrypotter students              # All Hogwarts students
harrypotter staff                 # All Hogwarts staff
harrypotter house gryffindor      # Gryffindor members
harrypotter house slytherin       # Slytherin members
harrypotter spells 15             # First 15 spells
harrypotter search "hermione"     # Find character by name

Output

Character output:

🧙 Harry Potter — Gryffindor, Half-blood, Patronus: Stag
🧙 Hermione Granger — Gryffindor, Muggleborn, Patronus: Otter
🧙 Draco Malfoy — Slytherin, Pure-blood

Search output (detailed):

🧙 Hermione Granger — Gryffindor, muggleborn, Patronus: otter
   Actor: Emma Watson
   Wand: vine, dragon heartstring, 10.75"
   Born: 19-09-1979

Spell output:

✨ Expelliarmus — Disarms your opponent
✨ Lumos — Creates a small light at the wand's tip
✨ Avada Kedavra — The Killing Curse

Notes

Uses HP-API (hp-api.onrender.com)
No authentication required
Houses: gryffindor, slytherin, hufflepuff, ravenclaw
Default limit is 20 items per query
Search is case-insensitive

Agent Implementation Notes

Platform note: If your human is on Windows, they'll need WSL, Git Bash, or Cygwin to run this skill.

Script location:

{skill_folder}/harrypotter

(wrapper to

scripts/harrypotter

)

When user asks about Harry Potter:

Run
```
./harrypotter search "name"
```
for specific characters
Run
```
./harrypotter house <name>
```
for house members
Run
```
./harrypotter spells
```
for spell information

Run

./harrypotter students

./harrypotter staff

for role-based lists

House names (case-insensitive):

gryffindor
slytherin
hufflepuff
ravenclaw

Don't use for: Non-HP fantasy content, general trivia not in the API.