docs(skills): lead the clide skill description with the entry action (T-512)
FR-2: settled-reach's drifted copy of the skill had a sharper opening — naming clide-on-PATH + CLIDE_SOCK and `clide capabilities` as the first move — which de-forking back to canonical would have dropped. The description is what an agent reads when deciding whether to invoke the skill, so the entry action belongs up front. Frontmatter wording only. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
+4
-31
@@ -17,36 +17,9 @@ in the D-record.
|
||||
|
||||
---
|
||||
|
||||
## FR-2 — Lead the `clide` skill `description` with `clide capabilities`
|
||||
|
||||
- **Status:** proposed
|
||||
- **Source:** settled-reach estate-cleanup session, 2026-07-13 — de-forking
|
||||
the hand-copied `clide` skill back to canonical surfaced a description
|
||||
improvement in the consumer's fork worth keeping.
|
||||
- **Severity:** low; discoverability wording, not a functional gap.
|
||||
|
||||
### Problem
|
||||
|
||||
The canonical `.claude/skills/clide/SKILL.md` `description` names the
|
||||
triggers but not the *first move*. settled-reach's drifted copy had a
|
||||
sharper opening that named `clide capabilities` as the entry action and the
|
||||
`clide`-on-PATH + `CLIDE_SOCK` mechanics inline. Syncing that copy back to
|
||||
canonical (de-forking) drops the improvement unless it's adopted here. The
|
||||
skill *body* already says "discover the surface first → `clide capabilities`",
|
||||
but the `description` — what an agent reads when *deciding* whether to invoke
|
||||
the skill — buries that lead.
|
||||
|
||||
### Proposal
|
||||
|
||||
Fold the fork's opening into the canonical `description` frontmatter:
|
||||
|
||||
> clide is the IDE hosting this session; it puts `clide` on your PATH and a
|
||||
> per-workspace socket in `CLIDE_SOCK`. Start with `clide capabilities` to
|
||||
> enumerate the live tool surface.
|
||||
## FR-2 — Lead the `clide` skill `description` with `clide capabilities` *(accepted → T-512, 2026-07-13)*
|
||||
|
||||
Applied: the canonical `.claude/skills/clide/SKILL.md` `description` now
|
||||
leads with the hosting context (`clide` on PATH, `CLIDE_SOCK`) and
|
||||
`clide capabilities` as the entry action, keeping the trigger list.
|
||||
Pure frontmatter wording; no behavior change.
|
||||
|
||||
---
|
||||
|
||||
*Logged from a settled-reach session (consuming the clide skill), not
|
||||
authored in a clide session — review and triage/commit from clide.*
|
||||
|
||||
Reference in New Issue
Block a user