Skip to content

Kore-Minecraft/Kore-Skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

kore-user-guide skill

An Agent Skills-compatible skill that teaches AI agents how to guide users with Kore, the Kotlin library for Minecraft Java Edition datapack generation.

Purpose

This repository packages practical, reusable guidance so an agent can:

  • Set up Kore projects correctly (Gradle, dependency, compiler flags).
  • Explain the core DSL workflow (dataPack, function, generate*).
  • Route users to official documentation by topic.
  • Distinguish end-user Kore usage from Kore contributor internals.

Repository structure

Kore-Skill/
├── SKILL.md          # Main skill metadata + instructions (required)
├── references/
│   └── REFERENCE.md  # Curated documentation map for fast navigation
├── .agentignore      # Excludes non-essential files from skill loading
└── README.md

Why this follows Agent Skills best practices

The skill is designed around the three-stage model documented on agentskills.io:

  • Discovery: concise metadata and triggers in SKILL.md.
  • Activation: complete instructions load only when Kore-related work is detected.
  • Execution: references point to official Kore docs and machine-readable indexes.
  • Calibration: includes defaults, boundaries, and gotchas to reduce false positives and vague outputs.
  • Progressive disclosure: keeps core instructions in SKILL.md and loads references/REFERENCE.md only when deeper navigation is needed.

Usage

  1. Place this folder where your agent client expects skills.
  2. Ensure the client can discover SKILL.md.
  3. Ask a Kore/datapack-related question (for example, setup, module choice, or generation flow).
  4. The client should activate this skill and follow the instructions.

Maintenance

  • Keep links aligned with https://kore.ayfri.com/docs/....
  • Update module guidance when Kore introduces breaking changes.
  • Keep examples and prerequisites current with Kotlin/JDK ecosystem updates.
  • Prefer official docs over inferred behavior from stale code snippets.

Related references

About

Teaches and guides use of Kore, the Kotlin library for generating Minecraft Java Edition datapacks.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors