git.iko.soy/crush
on main help sign in
refactor(skills): strip implementation hints from crush-owned descriptions

Descriptions should describe when a skill applies, not how it does its job. Leaving language like "using go doc", "the jq command-line processor", etc. in the trigger encourages the model to guess its way through without reading SKILL.md.

commit0a86d5f781eaa4b251724872a46a4bd15d97cc7d authorChristian Rocha <christian@rocha.is> dateSun 19 Apr 2026, 15:11 (6 months ago) parente64db33
4 files changed+4−4
compare with main
unifiedsplit
.agents/skills/builtin-skills/SKILL.md+1−1 .agents/skills/shell-builtins/SKILL.md+1−1 internal/skills/builtin/crush-config/SKILL.md+1−1 internal/skills/builtin/jq/SKILL.md+1−1
.agents/skills/builtin-skills/SKILL.md+1−1
@@ -1,6 +1,6 @@
11---
22name: builtin-skills
3−description: Guide for adding and modifying builtin skills embedded in the Crush binary. Use when creating a new builtin skill, editing an existing one, or understanding how the embedded skill system works (internal/skills/builtin/).
3+description: Use when creating a new builtin skill for Crush, editing an existing builtin skill (internal/skills/builtin/), or when the user needs to understand how the embedded skill system works.
44---
55
66# Builtin Skills
.agents/skills/shell-builtins/SKILL.md+1−1
@@ -1,6 +1,6 @@
11---
22name: shell-builtins
3−description: Guide for adding and modifying shell builtin commands in Crush's embedded shell (internal/shell/). Use when creating a new builtin command, editing an existing one, or understanding how commands are intercepted in the mvdan/sh interpreter.
3+description: Use when creating a new shell builtin command for Crush (internal/shell/), editing an existing one, or when the user needs to understand how commands are intercepted in Crush's embedded shell.
44---
55
66# Shell Builtins
internal/skills/builtin/crush-config/SKILL.md+1−1
@@ -1,6 +1,6 @@
11---
22name: crush-config
3−description: Configure Crush settings including providers, LSPs, MCPs, skills, permissions, and behavior options. Use when the user needs help with crush.json configuration, setting up providers, configuring LSPs, adding MCP servers, or changing Crush behavior.
3+description: Use when the user needs help configuring Crush — working with crush.json, setting up providers, configuring LSPs, adding MCP servers, managing skills or permissions, or changing Crush behavior.
44---
55
66# Crush Configuration
internal/skills/builtin/jq/SKILL.md+1−1
@@ -1,6 +1,6 @@
11---
22name: jq
3−description: Process, filter, transform, generate, and construct JSON data using the jq command-line processor. Crush includes a built-in jq implementation (powered by gojq) available in the bash tool. Use when the user needs to query, filter, reshape, extract, create, or construct JSON — including API responses, config files, log output, or any structured data. Also use when generating JSON from scratch with jq -n, or when helping users write or debug jq expressions.
3+description: Use when the user needs to query, filter, reshape, extract, create, or construct JSON data — including API responses, config files, log output, or any structured data — or when helping the user write or debug JSON transformations.
44---
55
66# jq — Built-in JSON Processor