kit skill # Install the Kit extensions skill via skills.shControl which skills are loaded at startup:
+# Load a specific skill file
+kit --skill path/to/skill.md "prompt"
+
+# Load multiple skill files or directories (flag is repeatable)
+kit --skill ./skill1.md --skill ./skill2.md "prompt"
+
+# Load all skills from a custom directory instead of the default locations
+kit --skills-dir /path/to/skills "prompt"
+
+# Disable all skill loading (auto-discovery and explicit)
+kit --no-skills "prompt"Skills are auto-discovered from ~/.config/kit/skills/, .kit/skills/, and .agents/skills/ by default. Use --skills-dir to override the project-local search root, or --skill to load files explicitly (which disables auto-discovery). --no-skills suppresses all skill loading regardless of other flags.
These commands are available inside the Kit TUI during an interactive session:
| — | Specific template to load by name | +||
no-skills |
+bool | +false |
+Disable skill loading (auto-discovery and explicit) | +
skill |
+list | +— | +Explicit skill files or directories to load (disables auto-discovery) | +
skills-dir |
+string | +— | +Override the project-local directory used for skill auto-discovery | +
model:, thinking-level:)~/.config/kit/preferences.yml)| Flag | +Short | +Default | +Description | +
|---|---|---|---|
--skill |
+— | +— | +Load skill file or directory (repeatable) | +
--skills-dir |
+— | +— | +Override the project-local skills directory for auto-discovery | +
--no-skills |
+— | +false |
+Disable skill loading (auto-discovery and explicit) | +
| Enable debug logging | -
Page not found
",pageComponent:d!=null&&d.isMdx?d.component:void 0,mdxComponents:eg,pageTitle:(d==null?void 0:d.frontmatter.title)||(v?"":"Not Found"),pageDescription:d==null?void 0:d.frontmatter.description,headings:(d==null?void 0:d.headings)||[],tocEnabled:(d==null?void 0:d.frontmatter.toc)!==!1,editUrl:xt,lastUpdated:K==null?void 0:K.lastUpdated,changelogEntries:d!=null&&d.isMdx||d==null?void 0:d.changelogEntries,apiManifest:!(d!=null&&d.isMdx)&&(d!=null&&d.isApiReference)?d.apiManifest:void 0,apiBaseUrl:(W=Jn.api)==null?void 0:W.baseUrl,apiPlayground:(I=Jn.api)==null?void 0:I.playground,apiAuth:(ct=Jn.api)==null?void 0:ct.auth,ApiReferenceComponent:H0,onNavigate:D,allPages:R,docContext:b0,versioning:void 0,currentVersion:nt,basePath:ko,isDraft:((Q=K==null?void 0:K.frontmatter)==null?void 0:Q.draft)===!0,dir:At,i18n:void 0,currentLocale:Ot,overrides:x0})]})}const om=document.getElementById("tome-root");om&&Bp.createRoot(om).render(s.jsx(ig,{})); +`,_o=(Jn.basePath||"/").replace(/\/$/,"");function lg(u){return cm(u,_o,Wn)}function Wu(u){return f0(u,_o,Wn)}const pm=p0(window.location.pathname,window.location.hash,Wn,_o,cm),ag=fm(pm,Wn,dm);function ig(){var W,I,ct,Q;const[u,p]=w.useState(pm),[d,c]=w.useState(null),[v,E]=w.useState(!0),j=w.useRef(0),D=w.useCallback(async(Y,L)=>{const U=++j.current;E(!0);let lt;try{lt=await fm(Y,Wn,dm)}catch(P){if(j.current!==U)return;console.error(`[tome] Navigation failed for page: ${Y}`,P),lt=null}if(j.current!==U)return;const at=Wu(Y);if(L!=null&&L.replace?window.history.replaceState(null,"",at):window.history.pushState(null,"",at),p(Y),c(lt),E(!1),!(L!=null&&L.skipScroll)){const P=window.location.hash.slice(1);P?requestAnimationFrame(()=>{const mt=document.getElementById(P);mt&&mt.scrollIntoView({behavior:"smooth",block:"start"})}):window.scrollTo(0,0)}},[]);w.useEffect(()=>{const Y=window.location.hash.slice(1);if(Y&&Wn.some(L=>L.id===Y)){const L=Wu(Y);window.history.replaceState(null,"",L),D(Y,{replace:!0})}else{const L=Wu(u);window.history.replaceState(null,"",L),ag.then(U=>{c(U),E(!1)})}},[]),w.useEffect(()=>{const Y=()=>{const L=lg(window.location.pathname);L&&L!==u&&D(L,{replace:!0,skipScroll:!0})};return window.addEventListener("popstate",Y),()=>window.removeEventListener("popstate",Y)},[u,D]);const C=w.useRef(null),[y,G]=w.useState(()=>{var L,U;if(typeof document>"u")return"light";if(document.documentElement.classList.contains("dark"))return"dark";const Y=((L=Jn.theme)==null?void 0:L.mode)||"auto";return Y==="dark"?"dark":Y==="light"?"light":(U=window.matchMedia)!=null&&U.call(window,"(prefers-color-scheme: dark)").matches?"dark":"light"});w.useEffect(()=>{const Y=new MutationObserver(()=>{const L=document.documentElement.classList.contains("dark");G(L?"dark":"light")});return Y.observe(document.documentElement,{attributes:!0,attributeFilter:["class"]}),()=>Y.disconnect()},[]),w.useEffect(()=>{const Y=document.querySelectorAll(".tome-mermaid[data-mermaid]");if(Y.length===0)return;let L=!1;const U="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs";return(async()=>{try{C.current||(C.current=(await import(U)).default);const lt=C.current;if(L)return;const at=y==="dark",P=getComputedStyle(document.documentElement).getPropertyValue("--font-body").trim()||"sans-serif";lt.initialize({startOnLoad:!1,theme:at?"dark":"default",fontFamily:P,flowchart:{padding:15,nodeSpacing:30,rankSpacing:40}});for(let mt=0;mtPage not found
",pageComponent:d!=null&&d.isMdx?d.component:void 0,mdxComponents:eg,pageTitle:(d==null?void 0:d.frontmatter.title)||(v?"":"Not Found"),pageDescription:d==null?void 0:d.frontmatter.description,headings:(d==null?void 0:d.headings)||[],tocEnabled:(d==null?void 0:d.frontmatter.toc)!==!1,editUrl:xt,lastUpdated:K==null?void 0:K.lastUpdated,changelogEntries:d!=null&&d.isMdx||d==null?void 0:d.changelogEntries,apiManifest:!(d!=null&&d.isMdx)&&(d!=null&&d.isApiReference)?d.apiManifest:void 0,apiBaseUrl:(W=Jn.api)==null?void 0:W.baseUrl,apiPlayground:(I=Jn.api)==null?void 0:I.playground,apiAuth:(ct=Jn.api)==null?void 0:ct.auth,ApiReferenceComponent:H0,onNavigate:D,allPages:R,docContext:b0,versioning:void 0,currentVersion:nt,basePath:_o,isDraft:((Q=K==null?void 0:K.frontmatter)==null?void 0:Q.draft)===!0,dir:At,i18n:void 0,currentLocale:Ot,overrides:x0})]})}const om=document.getElementById("tome-root");om&&Bp.createRoot(om).render(s.jsx(ig,{})); diff --git a/cli/commands/index.html b/cli/commands/index.html index 489254c1..6d639578 100644 --- a/cli/commands/index.html +++ b/cli/commands/index.html @@ -7,7 +7,7 @@ - + @@ -66,6 +66,26 @@ kit install --all # Install all extensions without prompting kit skill # Install the Kit extensions skill via skills.sh ``` +### Skills CLI flags + +Control which skills are loaded at startup: + +```bash +# Load a specific skill file +kit --skill path/to/skill.md "prompt" + +# Load multiple skill files or directories (flag is repeatable) +kit --skill ./skill1.md --skill ./skill2.md "prompt" + +# Load all skills from a custom directory instead of the default locations +kit --skills-dir /path/to/skills "prompt" + +# Disable all skill loading (auto-discovery and explicit) +kit --no-skills "prompt" +``` + +Skills are auto-discovered from `~/.config/kit/skills/`, `.kit/skills/`, and `.agents/skills/` by default. Use `--skills-dir` to override the project-local search root, or `--skill` to load files explicitly (which disables auto-discovery). `--no-skills` suppresses all skill loading regardless of other flags. + ## Interactive slash commands These commands are available inside the Kit TUI during an interactive session: diff --git a/cli/flags/index.html b/cli/flags/index.html index 2b62058c..1533ec73 100644 --- a/cli/flags/index.html +++ b/cli/flags/index.html @@ -7,7 +7,7 @@ - + @@ -58,6 +58,14 @@ These flags control Kit's behavior. When a prompt is passed as a positional argu | `--prompt-template` | — | — | Load a specific prompt template by name | | `--no-prompt-templates` | — | `false` | Disable prompt template loading | +## Skills + +| Flag | Short | Default | Description | +|------|-------|---------|-------------| +| `--skill` | — | — | Load skill file or directory (repeatable) | +| `--skills-dir` | — | — | Override the project-local skills directory for auto-discovery | +| `--no-skills` | — | `false` | Disable skill loading (auto-discovery and explicit) | + ## Generation parameters | Flag | Short | Default | Description | diff --git a/configuration/index.html b/configuration/index.html index 4040cabf..107841e6 100644 --- a/configuration/index.html +++ b/configuration/index.html @@ -7,7 +7,7 @@ - + @@ -57,6 +57,9 @@ stream: true | `theme` | object or string | — | UI theme ([inline overrides or file path](/themes)) | | `prompt-templates` | bool | `true` | Enable prompt template loading | | `prompt-template` | string | — | Specific template to load by name | +| `no-skills` | bool | `false` | Disable skill loading (auto-discovery and explicit) | +| `skill` | list | — | Explicit skill files or directories to load (disables auto-discovery) | +| `skills-dir` | string | — | Override the project-local directory used for skill auto-discovery | ## Environment variables diff --git a/development/index.html b/development/index.html index 5da7afb4..0202ff95 100644 --- a/development/index.html +++ b/development/index.html @@ -7,7 +7,7 @@ - + diff --git a/extensions/capabilities/index.html b/extensions/capabilities/index.html index 72ade0d0..2152d955 100644 --- a/extensions/capabilities/index.html +++ b/extensions/capabilities/index.html @@ -7,7 +7,7 @@ - + diff --git a/extensions/examples/index.html b/extensions/examples/index.html index ca0a6c71..ab67409e 100644 --- a/extensions/examples/index.html +++ b/extensions/examples/index.html @@ -7,7 +7,7 @@ - + diff --git a/extensions/loading/index.html b/extensions/loading/index.html index 6ad8d83e..656bb550 100644 --- a/extensions/loading/index.html +++ b/extensions/loading/index.html @@ -7,7 +7,7 @@ - + diff --git a/extensions/overview/index.html b/extensions/overview/index.html index 3681e22b..4e6ad493 100644 --- a/extensions/overview/index.html +++ b/extensions/overview/index.html @@ -7,7 +7,7 @@ - + diff --git a/extensions/testing/index.html b/extensions/testing/index.html index 52742a3f..93a1c176 100644 --- a/extensions/testing/index.html +++ b/extensions/testing/index.html @@ -7,7 +7,7 @@ - + diff --git a/index.html b/index.html index 50653384..d71b4f2e 100644 --- a/index.html +++ b/index.html @@ -15,7 +15,7 @@ ::-webkit-scrollbar-track { background: transparent; } ::-webkit-scrollbar-thumb { background: #333; border-radius: 3px; } - + diff --git a/installation/index.html b/installation/index.html index debacc75..0b1af8bf 100644 --- a/installation/index.html +++ b/installation/index.html @@ -7,7 +7,7 @@ - + diff --git a/llms-full.txt b/llms-full.txt index fafb7c88..2dd5fe7b 100644 --- a/llms-full.txt +++ b/llms-full.txt @@ -397,6 +397,26 @@ kit install --all # Install all extensions without prompting kit skill # Install the Kit extensions skill via skills.sh ``` +### Skills CLI flags + +Control which skills are loaded at startup: + +```bash +# Load a specific skill file +kit --skill path/to/skill.md "prompt" + +# Load multiple skill files or directories (flag is repeatable) +kit --skill ./skill1.md --skill ./skill2.md "prompt" + +# Load all skills from a custom directory instead of the default locations +kit --skills-dir /path/to/skills "prompt" + +# Disable all skill loading (auto-discovery and explicit) +kit --no-skills "prompt" +``` + +Skills are auto-discovered from `~/.config/kit/skills/`, `.kit/skills/`, and `.agents/skills/` by default. Use `--skills-dir` to override the project-local search root, or `--skill` to load files explicitly (which disables auto-discovery). `--no-skills` suppresses all skill loading regardless of other flags. + ## Interactive slash commands These commands are available inside the Kit TUI during an interactive session: @@ -572,6 +592,14 @@ These flags control Kit's behavior. When a prompt is passed as a positional argu | `--prompt-template` | — | — | Load a specific prompt template by name | | `--no-prompt-templates` | — | `false` | Disable prompt template loading | +## Skills + +| Flag | Short | Default | Description | +|------|-------|---------|-------------| +| `--skill` | — | — | Load skill file or directory (repeatable) | +| `--skills-dir` | — | — | Override the project-local skills directory for auto-discovery | +| `--no-skills` | — | `false` | Disable skill loading (auto-discovery and explicit) | + ## Generation parameters | Flag | Short | Default | Description | @@ -641,6 +669,9 @@ stream: true | `theme` | object or string | — | UI theme ([inline overrides or file path](/themes)) | | `prompt-templates` | bool | `true` | Enable prompt template loading | | `prompt-template` | string | — | Specific template to load by name | +| `no-skills` | bool | `false` | Disable skill loading (auto-discovery and explicit) | +| `skill` | list | — | Explicit skill files or directories to load (disables auto-discovery) | +| `skills-dir` | string | — | Override the project-local directory used for skill auto-discovery | ## Environment variables diff --git a/mcp.json b/mcp.json index 3534c58d..164e1eaf 100644 --- a/mcp.json +++ b/mcp.json @@ -56,6 +56,7 @@ "Extension management", "Installing extensions from git", "Skills", + "Skills CLI flags", "Interactive slash commands", "Prompt history", "Cancelling operations", @@ -70,7 +71,7 @@ "ACP server" ], "tags": [], - "content": "\n# Commands\n\n## Authentication\n\nFor OAuth-enabled providers like Anthropic.\n\n```bash\nkit auth login [provider] # Start OAuth flow (e.g., anthropic)\nkit auth login [provider] --set-default # Set provider's default model as system default\nkit auth logout [provider] # Remove credentials for provider\nkit auth status # Check authentication status\n```\n\n## Model database\n\nManage the local model database that maps provider names to API configurations.\n\n```bash\nkit models [provider] # List available models (optionally filter by provider)\nkit models --all # Show all providers (not just LLM-compatible)\nkit update-models [source] # Update model database\n```\n\nThe `update-models` command accepts an optional source argument:\n- *(none)* — update from [models.dev](https://models.dev)\n- A URL — fetch from a custom endpoint\n- A file path — load from a local file\n- `embedded` — reset to the bundled database\n\n## Extension management\n\n```bash\nkit extensions list # List discovered extensions\nkit extensions validate # Validate extension files\nkit extensions init # Generate example extension template\n```\n\n### Installing extensions from git\n\n```bash\nkit install