@victortomaili/skill-cli 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -11,6 +11,26 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Cursor adapter (`.cursor/rules` format) for `init -g` bootstrap.
 - Per-agent hook adapters for automatic `/X` triggering (push model).
 
+## [0.6.3] - 2026-07-07
+
+### Changed
+- AGENTS.md START GATE: clarified the load-vs-propose line. The agent now AUTO-LOADS
+  (silently) any skill needed to do the task at all, OR that makes the work HIGHER
+  QUALITY / more correct (domain knowledge, best-practice, standards, a quality
+  methodology). It PROPOSES only optional EXPERIENCE changes — response
+  style/format/mode, context-cost/token optimization, and optional shortcuts
+  (easier/faster, not about correctness). When unsure, propose.
+
+## [0.6.2] - 2026-07-07
+
+### Changed
+- AGENTS.md START GATE: stricter, broader PROPOSE rule. The agent now auto-loads
+  only skills STRICTLY NECESSARY to attempt the task, and PROPOSES (waits for user
+  confirmation) everything else — explicitly including: response STYLE/format/mode
+  skills, CONTEXT-COST / token optimizers, ACTIVATE-BEFORE-WORK workflows, and any
+  facilitator/accelerator that would make the job EASIER or FASTER. When unsure,
+  propose (propose is the safe default; loading is silent).
+
 ## [0.6.1] - 2026-07-07
 
 ### Changed

package/README.md

@@ -198,13 +198,14 @@ instruction file (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`):
 
 > **START GATE:** on the first user message, your VERY FIRST action — BEFORE
 > ANYTHING ELSE (before thinking, before any tool call) — is `skill active`, the
-> skill **catalog** (every skill's name + full description; never the body). Read
-> it and decide per skill from its description: **functional** for the task → load
-> it (`skill cat <name>`); **context-altering** (changes HOW you respond —
-> style/mode) → **propose**, apply only after the user confirms (`/X` = confirm).
-> **LOADED ≠ LISTED**: a skill is loaded only if you `cat`-ed it this session —
-> listing it (or its ★ / `active` status) is not loading. Any skill can be
-> context-altering; the agent judges from the description (no flag, no fixed list).
+> skill **catalog** (every active skill's name + full description; never the body).
+> Read it and decide per skill from its description: **AUTO-LOAD** (silently) anything
+> needed to do the task at all, or that makes the work **higher-quality / more
+> correct** (domain knowledge, best-practice, standards). **PROPOSE** (apply only
+> after the user confirms; `/X` = confirm) anything that's an optional change to the
+> *experience* — response **style/format/mode**, **context-cost** optimization, or an
+> optional **shortcut** (easier/faster, not about correctness). When unsure, propose.
+> **LOADED ≠ LISTED**: a skill is loaded only if you `cat`-ed it this session.
 > `/X` → `skill trigger X`.
 
 It's wrapped in `<!-- BEGIN skill-cli --> … <!-- END skill-cli -->` markers, never

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@victortomaili/skill-cli",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "Cross-agent skill manager — one global store, clean agent folders, activation via skill.config",
   "license": "MIT",
   "author": "Victor Tomaili <victor@tomaili.com>",

package/src/commands/defaults.js

@@ -16,7 +16,7 @@ export function cmdActive() {
   const eff = computeEffective(installed, globalCfg, projCfg)
   const defs = new Set((globalCfg.defaults || []).map(d => String(d).toLowerCase()))
 
-  console.log(c.bold('skill active') + c.gray(' — active skills in this project (descriptions only; functional → `skill cat`, context-altering → propose)'))
+  console.log(c.bold('skill active') + c.gray(' — active skills (descriptions only). AUTO-LOAD what is necessary or quality-improving; PROPOSE style/cost/shortcut skills and wait for confirmation.'))
   console.log()
 
   if (eff.length === 0) {

package/src/lib/agents-md.js

@@ -28,10 +28,16 @@ action — BEFORE ANYTHING ELSE: before you start thinking/reasoning about the t
 and before any tool call — MUST be to run \`skill active\`. It prints the skill
 CATALOG — every ACTIVE skill's name + FULL description (NOT the skill body).
 Read it, then for EACH skill decide FROM ITS DESCRIPTION:
-- Functional / useful for THIS task → load it: \`skill cat <name>\`.
-- Changes HOW you respond (a style, tone, format, or persistent MODE — e.g. a
-  brevity/compression style) → it is CONTEXT-ALTERING: PROPOSE it to the user and
-  apply ONLY after they confirm (\`/X\` = confirm). Do NOT load/apply it yourself.
+- AUTO-LOAD it (\`skill cat <name>\`, silently) when it is needed to do the task AT
+  ALL, OR when it would make the work HIGHER QUALITY / more correct — domain
+  knowledge, best-practice, standards, a quality methodology. These are not
+  optional; they are how the job should be done.
+- PROPOSE it (tell the user what it does; apply ONLY after they confirm; \`/X\` =
+  confirm) when it is an OPTIONAL change to the EXPERIENCE, not to quality:
+  • response STYLE / tone / format / a persistent mode (e.g. a brevity style);
+  • CONTEXT-COST / token optimization;
+  • an optional ACCELERATOR / shortcut (easier or faster, but not about correctness).
+When unsure → PROPOSE (proposing is the safe default; loading is silent).
 LOADED ≠ LISTED. A skill is loaded ONLY if you have run \`skill cat <name>\` for
 it THIS session. Seeing a skill in \`skill active\` / \`skill list\` does NOT load
 it — you then know only its name + description, nothing more. Never infer a skill