KungFu gateway
kungfu is a CLI gateway that streams Agent Skills, reference guides, and companion scripts into your session on demand.
[!CAUTION] DO NOT LEAK KUNGFU NOTATION INTO OTHER SKILLS OR OUTPUT TEXT: NEVER write, embed, or leak KungFu notation into any other
SKILL.mddefinition,README.md, documentation file, code comment, commit message, article, or agent output text unless the user explicitly tells you otherwise.
[!IMPORTANT] CLI Version Check (
v0.7.1): Comparekungfu --versionagainst this skill's frontmatterversion(0.7.1). If the installedkungfubinary is older than0.7.1, upgrade the CLI and synchronize all catalogs immediately:go install github.com/danicat/kungfu@latest && kungfu update
Activation triggers
Activate kungfu whenever you encounter:
- Shortcut notation:
::notation(such as::godoctor,::go@go-skills,::?search,::godoctor!test,::parallel(10), or::discovery -> ::implementation). - Double-slash commands:
//<skill-name>(such as//godoctoror//ebitengineer). - Unknown commands: A command or workflow not present in your active session.
- Domain tasks: Tasks in domains where a skill playbook exists (such as Go refactoring, 2D game physics, audio synthesis, or SEO audits).
1. Search and discovery (kungfu find / ::?)
Use kungfu find to search skills by keyword using hybrid BM25 + exact/fuzzy RRF ranking:
kungfu find game
kungfu find seo
kungfu find audio
kungfu find ast2. Just-in-time loading (kungfu load / ::skill)
Stream skill instructions into your session without saving files to the workspace.
[!IMPORTANT] Buffer limit and pagination:
- Command execution buffers cap output at 8,192 bytes (8 KiB).
- Output over 8,192 bytes truncates from the top, dropping the title and initial instructions.
kungfu loadpaginates automatically (~6,000 bytes per page) to prevent truncation.- Load skills one at a time (
kungfu load skillA skillBreturns an error).
# Load page 1 of a skill
kungfu load ebitengineer
# Read later pages
kungfu load ebitengineer -p 2
kungfu load ebitengineer --page 3
# Load from a specific catalog
kungfu load go@go-skills
# Stream raw markdown including frontmatter
kungfu load godoctor --raw
# Read from local cache only or force an upstream refresh
kungfu load godoctor --local
kungfu load godoctor -u -f3. Load references and assets (kungfu load <skill>/<subpath>)
Load reference guides, playbooks, schemas, or assets bundled inside a skill:
kungfu load godoctor/references/architecture.md
kungfu load buffer/references/pitfalls.md
kungfu load social-copy/references/linkedin_playbook.md
kungfu load buffer-analytics/assets/schema.sql4. Run companion scripts (kungfu run / ::skill!script)
Run scripts bundled in a skill's scripts/ directory.
[!IMPORTANT] Always use
kungfu run:
- Do not search the filesystem for script files.
kungfu learnis not required;kungfu runfetches and caches scripts on demand.kungfu runselects the runtime (uv,python3,bun,deno,node, orbash) and runs in the current working directory.
kungfu run godoctor smart_build
kungfu run buffer sync.py --dry-run
kungfu run godoctor analyze_ast --package ./internal/...5. Shortcut dialect (::notation)
KungFu uses a compact shortcut notation for human-agent pair programming. When the user writes ::notation or //skill in a prompt, run the matching kungfu CLI commands and workflow steps below.
Shortcut reference table
| Notation | Command | Purpose |
|---|---|---|
::?keyword |
kungfu find keyword |
Discover skills by keyword using hybrid BM25 + exact/fuzzy RRF search |
::?keyword@catalog |
kungfu find keyword@catalog |
Discover skills within a specific catalog |
::skill (or //skill) |
kungfu load skill |
JIT load a skill from the default catalog (::skill@default) |
::skill@catalog |
kungfu load skill@catalog |
JIT load a skill from a specific catalog (such as ::go@go-skills) |
::skill/subpath |
kungfu load skill/subpath |
Load a reference or asset (such as ::godoctor/references/architecture.md) |
::skill!script [args] |
kungfu run skill script [args] |
Run a companion script (such as ::godoctor!smart_build) |
::skill(params...) |
Load + specialize skill | Specialize a skill with runtime arguments, worker counts, or inner skills |
A -> B |
Sequential chain | Chain skills and slash commands left-to-right |
Grammar and composition rules
- Catalog and path scoping (
@catalogand/subpath):- Omitting
@cataloguses the default catalog:::godoctorequals::godoctor@default. - Adding
@catalogselects a named catalog:::go@go-skillsloadsgofromgo-skills. - Adding
/subpathloads a file from the skill:::godoctor/references/architecture.md. - If a name doesn't match an exact skill,
kungfu loadreturns the top 5 fuzzy and hybridDid you meanmatches.
- Omitting
- Skill arguments (
::skill(params...)):- Use
()to pass runtime flags, worker counts, tier hints, workspace modes, or inner skills. - Values inside
()have no fixed order:::parallel(10),::double-diamond(10), and::parallel(10, ::discovery)(which equals::parallel(::discovery, 10)). - If arguments inside
()are ambiguous (such as::parallel(10, 20)), ask the user to clarify before proceeding. - Common values include worker counts (
10), tier or effort flags (flash, low), workspace modes (branch,share), and inner skills (::discovery).
- Use
- Sequential chains (
A -> B):- The
->arrow chains skills and slash commands left-to-right into a multi-stage flow:::discovery(10) -> /grill-me -> ::implementation(5) - Finish each stage in order before starting the next stage.
- The
- First-mention hint rule:
- The
::(or//) prefix is a JIT-loading trigger needed only on the first mention of a skill in a prompt. - Once you name a skill in a prompt, later mentions in that prompt or chain don't need the
::prefix (such as::parallel(10, ::discovery) -> /grill-me -> parallel(5, implementation)).
- The
6. Persistence and administration
# Install skills to workspace or global scope
kungfu learn godoctor
kungfu learn go@go-skills
kungfu learn danicat/kungfu
kungfu learn godoctor --load
# List and inspect skills
kungfu list
kungfu show <skill>
# Check installed skills and usage history
kungfu status
kungfu status -g
# Synchronize catalogs, flush telemetry, and check or apply skill updates
kungfu update
kungfu update --all
# Uninstall skills
kungfu forget <skill>
kungfu forget <skill> -g
# Manage skill catalogs
kungfu catalog add google/skills
kungfu catalog list
kungfu catalog remove google/skills
# Manage opt-in anonymous community telemetry
kungfu telemetry status
kungfu telemetry enable
kungfu telemetry disable
kungfu telemetry sync
kungfu telemetry sync -bCore rules
- Run scripts via
kungfu run: Never search disk for skill scripts. Runkungfu run <skill> <script> [args]. - Stream by default: Use
kungfu loadunless the user asks to install a skill permanently withkungfu learn.