Skip to content
T1KTheOneKit

t1k:find-skill

FieldValue
Modulet1k-base
Version2.17.3
Effortlow
Tools—

Keywords: available, discover, find, list, lookup, search, skills

How to invoke

Section titled “How to invoke”
/t1k:find-skill
<query> [--all] [--installed-only]

TheOneKit Find-Skill — Skill Discovery

Section titled “TheOneKit Find-Skill — Skill Discovery”

Search available skills by keyword when you need to know what capability exists. Critical as module count grows across kits.

Usage

Section titled “Usage”
/t1k:find-skill "ECS batch processing"   # Find skills matching a query
/t1k:find-skill "auth"                   # All skills related to auth
/t1k:find-skill --all                    # List every available skill
/t1k:find-skill --all --installed-only   # Only installed skills

Algorithm

Section titled “Algorithm”

  1. Load activation sources:

    • Read ALL .claude/t1k-activation-*.json fragments → collect keyword-to-skill mappings
    • Read ALL installed module.json files → collect activation.keywords per module
    • Read ALL SKILL.md frontmatter (description field) for richer matching

    Scan caps the first 30 lines per file (frontmatter only) and limits results to 50 matches by default; use --all to bypass.

  2. Fuzzy-match query:

    • Tokenize user query into words
    • Match against: activation keywords, skill names, SKILL.md descriptions
    • Rank results:
      1. Exact keyword match (highest)
      2. Prefix match (query is prefix of keyword)
      3. Substring match (query appears inside keyword)
      4. Description match (query word appears in SKILL.md description)

  3. Resolve install status:

    • Read .claude/metadata.json → installedModules
    • Mark each result: [installed] or [not installed — module: {name}]

  4. Output results with install status, module, and description.

Output Format

Section titled “Output Format”
## Skills matching "ECS batch"


### Installed


| Skill | Module | Description |
|-------|--------|-------------|
| dots-ecs-core | dots-core (theonekit-unity) | ECS system patterns, burst compilation, job scheduling |
| dots-ecs-batch | dots-core (theonekit-unity) | Batch entity processing with IJobChunk and EntityQuery |


### Available (not installed)


| Skill | Module | Kit | Install Command |
|-------|--------|-----|-----------------|
| dots-ecs-advanced | dots-advanced | theonekit-unity | /t1k:modules add dots-advanced |


### No match in uninstalled modules.

—all Flag

Section titled “—all Flag”

Lists every available skill (no filtering). Output grouped by module:

## All Available Skills


### Core (always available)
- t1k:cook — End-to-end feature implementation
- t1k:fix — Bug fix workflow
- t1k:plan — Planning and architecture
- ...


### Module: dots-core (theonekit-unity) [installed v2.1.0]
- dots-ecs-core — ECS system patterns
- dots-physics — Physics simulation patterns
- ...


### Module: ui (theonekit-unity) [installed v1.3.0]
- unity-ui — UI toolkit patterns
- ...


### Module: rendering (theonekit-unity) [NOT INSTALLED]
  Install: /t1k:modules add rendering
- unity-rendering — SRP render pipeline patterns
- ...

Uninstalled Module Suggestion

Section titled “Uninstalled Module Suggestion”

When results include uninstalled modules, offer installation:

2 results found in uninstalled module 'dots-advanced'.
Install it? Run: /t1k:modules add dots-advanced

Do NOT auto-install — always ask the user first.

Category Browsing

Section titled “Category Browsing”

When no query provided (or --all), group skills by category (from module.json → category):

/t1k:find-skill --all --category "Testing & QA"

Available categories: Core Workflows, Planning & Analysis, Backend, Frontend & Design, Game Engine, Testing & QA, DevOps & CI/CD, Security, Documentation, Git & VCS, Kit Management, Utilities

Gotchas

Section titled “Gotchas”
  • Core skills are always available — they live in .claude/skills/ regardless of metadata
  • Fragment-only kits: Some older kits may not have module.json — fall back to t1k-activation-*.json only
  • Description quality varies: SKILL.md descriptions may be short; keyword matching is more reliable
  • Cross-kit skills: A skill installed from theonekit-designer appears in results even in a Unity project
  • Activation refs accept BOTH bare and full-prefixed forms — when resolving a mappings[].skills[] entry from a fragment to its skill dir, accept either nakama-rpc (bare slug) or t1k-nakama-rpc (full-prefixed dir name). The CI prefixer self-heals legacy bare refs to canonical form at release time, but the SSOT in fragment files stays bare. If a ref doesn’t resolve via either form, it’s drift — surface to the user (consult t1k-doctor check #47 or release-action validate-activation-skill-resolution.cjs).

Auto-Activation Keywords

Section titled “Auto-Activation Keywords”

Triggers on: find skill, search skill, what skill, available skills, discover, how do I, which skill, skill for, list skills, skill search