Index of every page on this site: llms.txt
All skills
danicat avatar

/kungfu

@c9a1a61
Run it yourself

"I know Kung Fu!": Activate this skill to acquire knowledge about anything immediately. It teaches how to discover skills with keywords, JIT load skills into context, load reference guides and assets, execute companion scripts, and use the KungFu pair-programming shortcut dialect. When encountering unknown commands, niche domains, or ::notation, activate kungfu.

  • 2 files
  • 14.5 KB
  • Apache-2
  • Updated 6 days ago
  • GitHub
Use this Skill: https://skilld.dev/gh/danicat/kungfu/kungfu

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈93 tokens for metadata: the name and description. ≈1.9k when used: this file. ≈1.7k more on demand in 1 file.

Description uses 4.7% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈373 characters, or 4.7%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

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.md definition, 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): Compare kungfu --version against this skill's frontmatter version (0.7.1). If the installed kungfu binary is older than 0.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:

  1. Shortcut notation: ::notation (such as ::godoctor, ::go@go-skills, ::?search, ::godoctor!test, ::parallel(10), or ::discovery -> ::implementation).
  2. Double-slash commands: //<skill-name> (such as //godoctor or //ebitengineer).
  3. Unknown commands: A command or workflow not present in your active session.
  4. 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 ast

2. 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 load paginates automatically (~6,000 bytes per page) to prevent truncation.
  • Load skills one at a time (kungfu load skillA skillB returns 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 -f

3. 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.sql

4. 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 learn is not required; kungfu run fetches and caches scripts on demand.
  • kungfu run selects the runtime (uv, python3, bun, deno, node, or bash) 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

  1. Catalog and path scoping (@catalog and /subpath):
    • Omitting @catalog uses the default catalog: ::godoctor equals ::godoctor@default.
    • Adding @catalog selects a named catalog: ::go@go-skills loads go from go-skills.
    • Adding /subpath loads a file from the skill: ::godoctor/references/architecture.md.
    • If a name doesn't match an exact skill, kungfu load returns the top 5 fuzzy and hybrid Did you mean matches.
  2. 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).
  3. 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.
  4. 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)).

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 -b

Core rules

  1. Run scripts via kungfu run: Never search disk for skill scripts. Run kungfu run <skill> <script> [args].
  2. Stream by default: Use kungfu load unless the user asks to install a skill permanently with kungfu learn.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No third-party reports yet.

Signed by skilld at c9a1a61. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated 6 days ago
Other metadata
metadata
{
  "category": "agents",
  "tags": "gateway, agent-skills, discovery, search, catalog, cli, learn, jit",
  "author": "Daniela Petruzalek (daniela@danicat.dev)",
  "version": "0.7.1",
  "catalog": "https://skills.danicat.dev"
}

README badge

README badge for danicat/kungfu