Imported from akillness/jeo-skills (
.agent-skills/jeo-skill/SKILL.md). Install upstream withnpx skills add akillness/jeo-skills --skill jeo-skill. Copyright stays with the author.
jeo-skill
When to use this skill
Use this skill as the lightweight catalog front door when the user needs to:
- discover skills by primary category and focused subcategory;
- install only one skill, a curated bundle, or one category slice;
- inspect related or overlapping skills before choosing one;
- avoid a full
.agent-skillscheckout in an agent runtime; - verify that the local catalog and the
jeo-skillexecutable are usable.
Do not physically move skill folders to represent taxonomy. Agent skill discovery expects
<skill-name>/SKILL.md; category and relationship metadata belongs in the central catalog.
Instructions
1. Link the CLI once
From a source checkout or an installed copy of this skill:
python3 scripts/jeo-skill.py link
jeo-skill doctor
This creates only ~/.local/bin/jeo-skill. It does not install the full catalog.
2. Browse before installing
jeo-skill categories
jeo-skill list --category web
jeo-skill list --category game --subcategory audio
jeo-skill search "responsive React design"
jeo-skill related code-review
The catalog uses ten stable primary categories:
web: frontend, backend, design, API, data, testing, accessibility, performanceinfrastructure: deployment, environment, observability, security, cloud/data, automationgame: client, web, server, design/UI, audio, animation, motion/VFX, sprite/image, art resources, storytelling, tooling, QA/performance, releasecreative-media: image, video, motion, audio, presentation, diagram, capture, storytellingcli-tools: developer, AI, media, automation, search, benchmark CLIsai-agents: orchestration, agent frameworks, skill authoring, evaluation, planning/reviewengineering: code quality, testing, architecture, documentationresearch: academic, web research, data analysis, benchmarkingbusiness: marketing, support, publishingutilities: knowledge, files, Git, workspace, project management, general utilities
3. Prefer the narrowest install
# Preview first; no files are installed.
jeo-skill install --bundle web-frontend --dry-run
jeo-skill install --category game --subcategory audio --dry-run
# Install globally after reviewing the selection.
jeo-skill install responsive-design react-best-practices --global --yes
jeo-skill install --bundle game-web --global --yes
The CLI delegates installation to npx skills add ... --skill ...; it never copies the
whole repository unless the user explicitly selects every skill. Omit --global for a
project-local install. Use --agent <runtime> to target a specific supported runtime.
4. Treat overlap as a routing relationship
jeo-skill related <name> shows catalog relationship groups. Keep adjacent tools as
separate skills when their runtime or job differs—for example, human code-review judgment
versus the ocr CLI. Use a canonical alias only when ordinary prompts truly compete and
backward-compatible exact-name installation is required.
5. Verify observable behavior
jeo-skill doctor
jeo-skill categories --json
jeo-skill install --bundle starter --dry-run
doctor must resolve a valid catalog and report Python/npx availability. A dry run must
print the exact selected skill names and installation command without changing the system.
Examples
# Web design and frontend implementation
jeo-skill list -c web -s design
jeo-skill install --bundle web-frontend --global --yes
# Focused game workflows
jeo-skill list -c game -s motion-vfx
jeo-skill related game-vfx
jeo-skill install game-vfx rfxgen --global --yes
# CLI-only discovery
jeo-skill list -c cli-tools --interface cli
Best practices
- Install by name or curated bundle before installing an entire category.
- Keep one central taxonomy projection; do not add category wrapper folders containing
duplicate
SKILL.mdfiles. - Connect neighboring skills with relationship groups rather than duplicating instructions.
- Keep heavy upstream apps, models, MCP servers, and runtimes on-demand inside each skill.
- Run
--dry-runbefore any multi-skill install and report the resolved selection.
References
- Catalog:
.agent-skills/skills.json - Compact projection:
.agent-skills/skills.toon - Agent Skills installer:
npx skills --help - Catalog validator:
scripts/validate-catalog-projections.py