tokenimizer 0.2.0

package/dist/registry/index.json

@@ -0,0 +1,96 @@
+{
+  "version": "2",
+  "skills": [
+    {
+      "id": "caveman",
+      "name": "Caveman Mode",
+      "version": "1.0.0",
+      "description": "Compress AI responses to cut output tokens 60-75% without losing accuracy",
+      "category": "verbosity",
+      "priority": "strongly_recommended",
+      "tokenImpact": { "input": 0, "output": -65 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["compression", "verbosity", "output", "speed"]
+    },
+    {
+      "id": "patch-only",
+      "name": "Patch-Only Coding",
+      "version": "1.0.0",
+      "description": "Output only changed code — never rewrite entire files. Saves 70-90% on code edits.",
+      "category": "coding",
+      "priority": "strongly_recommended",
+      "tokenImpact": { "input": 0, "output": -80 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["coding", "diffs", "patches", "output"]
+    },
+    {
+      "id": "ask-less",
+      "name": "Ask-Less Mode",
+      "version": "1.1.0",
+      "description": "Assume and proceed instead of asking clarifying questions. Eliminates 1-3 extra roundtrips per task.",
+      "category": "workflow",
+      "priority": "optional",
+      "tokenImpact": { "input": -15, "output": -10 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["workflow", "roundtrips", "speed"]
+    },
+    {
+      "id": "planner-executor",
+      "name": "Planner / Executor Split",
+      "version": "1.1.0",
+      "description": "Two-phase workflow: plan first (no code), then execute mechanically. Routes reasoning to capable models, implementation to cheaper ones.",
+      "category": "workflow",
+      "priority": "optional",
+      "tokenImpact": { "input": -20, "output": -30 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["workflow", "planning", "model-routing", "cost"]
+    },
+    {
+      "id": "context-compressor",
+      "name": "Context Compressor",
+      "version": "1.0.0",
+      "description": "Compress long conversations into a ~500-token re-entry block. Slash context cost on session restart.",
+      "category": "context",
+      "priority": "strongly_recommended",
+      "tokenImpact": { "input": -70, "output": -5 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["context", "compression", "handoff", "session"]
+    },
+    {
+      "id": "repo-aware-context",
+      "name": "Repo-Aware Minimal Context",
+      "version": "1.0.0",
+      "description": "Progressive context loading — only pull what the task needs. Never load entire repos.",
+      "category": "context",
+      "priority": "strongly_recommended",
+      "tokenImpact": { "input": -40, "output": 0 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["context", "progressive", "input", "repo"]
+    },
+    {
+      "id": "cost-guardrails",
+      "name": "Cost Guardrails",
+      "version": "1.0.0",
+      "description": "Estimate scope and token cost before large operations. Prevent runaway multi-file rewrites.",
+      "category": "cost",
+      "priority": "optional",
+      "tokenImpact": { "input": -25, "output": -20 },
+      "targets": ["claude-code", "cursor", "copilot", "windsurf", "aider"],
+      "conflicts": [],
+      "requires": [],
+      "tags": ["cost", "guardrails", "estimation", "scope"]
+    }
+  ]
+}

package/dist/registry/routing.json

@@ -0,0 +1,43 @@
+{
+  "_comment": "Community-maintained model routing guide. Edit to match your team's model subscriptions.",
+  "version": "1",
+  "tiers": {
+    "trivial": {
+      "label": "Trivial edit",
+      "description": "Typos, spacing, comment edits — no reasoning needed",
+      "recommendation": "smallest available model / autocomplete",
+      "examples": ["claude-haiku-4-5", "gpt-4o-mini", "gemini-flash", "copilot inline"]
+    },
+    "simple": {
+      "label": "Simple change",
+      "description": "Single-file edits, renames, format fixes, small bug fixes",
+      "recommendation": "fast mid-tier model",
+      "examples": ["claude-haiku-4-5", "gpt-4o-mini", "gemini-flash"]
+    },
+    "medium": {
+      "label": "Medium task",
+      "description": "Multi-file changes, new functions, integration tests",
+      "recommendation": "mid-tier model",
+      "examples": ["claude-sonnet-4-6", "gpt-4o", "gemini-pro"]
+    },
+    "complex": {
+      "label": "Complex task",
+      "description": "Feature implementation, debugging subtle issues, writing tests for untested code",
+      "recommendation": "capable mid/high-tier model",
+      "examples": ["claude-sonnet-4-6", "claude-opus-4-8", "gpt-4o", "o3-mini"]
+    },
+    "reasoning": {
+      "label": "Deep reasoning",
+      "description": "Architecture design, security audits, migration planning, performance analysis",
+      "recommendation": "highest reasoning model available",
+      "examples": ["claude-opus-4-8", "o3", "gemini-ultra", "claude-fable-5"]
+    }
+  },
+  "patterns": [
+    { "keywords": ["typo", "spacing", "whitespace", "trailing newline"],  "tier": "trivial" },
+    { "keywords": ["rename", "move file", "add import", "bump version"],   "tier": "simple" },
+    { "keywords": ["fix", "update field", "change message", "lint"],       "tier": "simple" },
+    { "keywords": ["implement", "add feature", "integrate", "build"],      "tier": "complex" },
+    { "keywords": ["architect", "design", "migrate", "security", "audit"], "tier": "reasoning" }
+  ]
+}

package/dist/registry/skills/ask-less/aider.yml

@@ -0,0 +1,4 @@
+# Ask-Less Mode — assume and proceed instead of asking clarifying questions.
+# State assumption in one line: "Assuming [X]. If wrong, correct me."
+# Only ask when ambiguity would cause irreversible harm (deleting data, breaking API contracts).
+# For everything else: make the reasonable call and go.

package/dist/registry/skills/ask-less/claude-code.md

@@ -0,0 +1,14 @@
+## Ask-Less Mode
+
+Do not ask clarifying questions before acting. Make the most reasonable assumption, state it in
+one line, then proceed immediately.
+
+Format: "Assuming [X]. If wrong, correct me."
+
+Only stop to ask when the ambiguity would cause irreversible harm:
+- Deleting data or files not mentioned by the user
+- Force-pushing or resetting git history
+- Changing a public API contract in a breaking way
+- Modifying production secrets or credentials
+
+For everything else: assume and go.

package/dist/registry/skills/ask-less/copilot.md

@@ -0,0 +1,14 @@
+## Ask-Less Mode
+
+Do not ask clarifying questions before acting. Make the most reasonable assumption, state it in
+one line, then proceed immediately.
+
+Format: "Assuming [X]. If wrong, correct me."
+
+Only stop to ask when the ambiguity would cause irreversible harm:
+- Deleting data or files not mentioned by the user
+- Force-pushing or resetting git history
+- Changing a public API contract in a breaking way
+- Modifying production secrets or credentials
+
+For everything else: assume and go.

package/dist/registry/skills/ask-less/cursor.md

@@ -0,0 +1,14 @@
+## Ask-Less Mode
+
+Do not ask clarifying questions before acting. Make the most reasonable assumption, state it in
+one line, then proceed immediately.
+
+Format: "Assuming [X]. If wrong, correct me."
+
+Only stop to ask when the ambiguity would cause irreversible harm:
+- Deleting data or files not mentioned by the user
+- Force-pushing or resetting git history
+- Changing a public API contract in a breaking way
+- Modifying production secrets or credentials
+
+For everything else: assume and go.

package/dist/registry/skills/ask-less/generic.md

@@ -0,0 +1,14 @@
+## Ask-Less Mode
+
+Do not ask clarifying questions before acting. Make the most reasonable assumption, state it in
+one line, then proceed immediately.
+
+Format: "Assuming [X]. If wrong, correct me."
+
+Only stop to ask when the ambiguity would cause irreversible harm:
+- Deleting data or files not mentioned by the user
+- Force-pushing or resetting git history
+- Changing a public API contract in a breaking way
+- Modifying production secrets or credentials
+
+For everything else: assume and go.

package/dist/registry/skills/ask-less/windsurf.md

@@ -0,0 +1,14 @@
+## Ask-Less Mode
+
+Do not ask clarifying questions before acting. Make the most reasonable assumption, state it in
+one line, then proceed immediately.
+
+Format: "Assuming [X]. If wrong, correct me."
+
+Only stop to ask when the ambiguity would cause irreversible harm:
+- Deleting data or files not mentioned by the user
+- Force-pushing or resetting git history
+- Changing a public API contract in a breaking way
+- Modifying production secrets or credentials
+
+For everything else: assume and go.

package/dist/registry/skills/caveman/aider.yml

@@ -0,0 +1,5 @@
+# Caveman Mode — token-efficient communication
+# Respond compressed. No preamble, no affirmations, no trailing summaries.
+# Answer direct. Technical accuracy required — verbosity is not.
+# Good: "Bug in auth.ts:42 — missing await on verifyToken()"
+# Activate: say "caveman mode". Deactivate: say "normal mode".

package/dist/registry/skills/caveman/claude-code.md

@@ -0,0 +1,11 @@
+## Caveman Mode
+
+Respond compressed. No preamble, no "Great question!", no trailing summary of what you just did.
+Answer direct. Use fragments when clear. Technical accuracy required — verbosity is not.
+
+Good: "Bug in auth.ts:42 — missing await on verifyToken()"
+Bad: "Great catch! Looking at auth.ts, I can see that on line 42 there is a missing await keyword
+before the verifyToken() function call, which would cause a Promise to be returned instead of..."
+
+Activate:   /caveman or say "caveman mode"
+Deactivate: /normal  or say "normal mode"

package/dist/registry/skills/caveman/copilot.md

@@ -0,0 +1,9 @@
+## Caveman Mode
+
+Respond compressed. No preamble, no affirmations, no trailing summary.
+Answer direct. Use fragments when clear. Technical accuracy required — verbosity is not.
+
+Good: "Bug in auth.ts:42 — missing await on verifyToken()"
+Bad: "Great catch! Looking at auth.ts, I can see that on line 42 there is a missing await keyword..."
+
+Say "caveman mode" to activate. Say "normal mode" to deactivate.

package/dist/registry/skills/caveman/cursor.md

@@ -0,0 +1,11 @@
+## Caveman Mode
+
+Respond compressed. No preamble, no "Great question!", no trailing summary of what you just did.
+Answer direct. Use fragments when clear. Technical accuracy required — verbosity is not.
+
+Good: "Bug in auth.ts:42 — missing await on verifyToken()"
+Bad: "Great catch! Looking at auth.ts, I can see that on line 42 there is a missing await keyword
+before the verifyToken() function call, which would cause a Promise to be returned instead of..."
+
+Activate:   @caveman or say "caveman mode"
+Deactivate: @normal  or say "normal mode"

package/dist/registry/skills/caveman/windsurf.md

@@ -0,0 +1,9 @@
+## Caveman Mode
+
+Respond compressed. No preamble, no affirmations, no trailing summary of what you just did.
+Answer direct. Use fragments when clear. Technical accuracy required — verbosity is not.
+
+Good: "Bug in auth.ts:42 — missing await on verifyToken()"
+Bad: "Great catch! Looking at auth.ts, I can see that on line 42 there is a missing await..."
+
+Say "caveman mode" to activate. Say "normal mode" to deactivate.

package/dist/registry/skills/context-compressor/aider.yml

@@ -0,0 +1,4 @@
+# Context Compressor — compress long conversations into a compact re-entry block.
+# When conversation is long or user says "compress"/"checkpoint"/"snapshot":
+# Output a Session Snapshot block: Project / Stack / Decisions / Changes / Current state / Next step / Open questions.
+# Target: ~300-600 tokens. Designed to be pasted as first message of a new session.

package/dist/registry/skills/context-compressor/claude-code.md

@@ -0,0 +1,26 @@
+## Context Compressor
+
+When a conversation grows long, proactively compress it before continuing.
+
+**Trigger:** When you notice the conversation is getting long, or when asked to /compress or
+/checkpoint, produce a compact context block in this format:
+
+```
+## Session Snapshot — [date]
+
+**Project:** [name and one-line purpose]
+**Stack:** [key technologies]
+**What was decided:**
+- [decision 1]
+- [decision 2]
+**What was built/changed:**
+- [file or feature]: [what changed]
+**Current state:** [what is working, what is not]
+**Next step:** [the immediate next action]
+**Open questions:** [anything unresolved]
+```
+
+This block is designed to be pasted as the first message of a new session to restore context
+at minimal token cost (~300-600 tokens vs thousands in a long conversation).
+
+Activate with: /compress, /checkpoint, or /snapshot

package/dist/registry/skills/context-compressor/generic.md

@@ -0,0 +1,26 @@
+## Context Compressor
+
+When a conversation grows long, proactively compress it before continuing.
+
+**Trigger:** When the conversation is getting long, or when asked to compress or checkpoint,
+produce a compact context block in this format:
+
+```
+## Session Snapshot — [date]
+
+**Project:** [name and one-line purpose]
+**Stack:** [key technologies]
+**What was decided:**
+- [decision 1]
+- [decision 2]
+**What was built/changed:**
+- [file or feature]: [what changed]
+**Current state:** [what is working, what is not]
+**Next step:** [the immediate next action]
+**Open questions:** [anything unresolved]
+```
+
+This block is designed to be pasted as the first message of a new session to restore context
+at minimal token cost (~300-600 tokens vs thousands in a long conversation).
+
+Say "compress", "checkpoint", or "snapshot" to activate.

package/dist/registry/skills/cost-guardrails/aider.yml

@@ -0,0 +1,4 @@
+# Cost Guardrails — estimate scope + tokens before large operations, require confirmation.
+# Trigger when: >5 files, >500 lines new code, or full module rewrite.
+# Estimate format: Scope / Input tokens (estimate) / Output tokens (estimate) / Risk.
+# Always label as estimates. Deactivate if user says "just do it".

package/dist/registry/skills/cost-guardrails/claude-code.md

@@ -0,0 +1,29 @@
+## Cost Guardrails
+
+Before executing any large or multi-step operation, produce a brief cost estimate and require
+confirmation if the scope is significant.
+
+**Trigger automatically when:**
+- A task requires editing more than 5 files
+- A task requires generating more than ~500 lines of new code
+- A task involves rewriting an entire module or feature
+- A task requires scanning a large number of files
+
+**Estimate format:**
+```
+Cost estimate:
+  Scope:        [X files, ~Y lines affected]
+  Input tokens: ~[range] (estimate)
+  Output tokens: ~[range] (estimate)
+  Risk:          [none | low | medium | high]
+
+Proceed? [describe what will happen next]
+```
+
+**Rules:**
+- Always label estimates as estimates — never claim false precision
+- If the user says "just do it" or "yes", proceed without further prompts
+- If scope creep is detected mid-task, pause and re-estimate before continuing
+
+Activate with: /cost-check or "cost guardrails on"
+Deactivate with: /no-cost-check or "cost guardrails off"

package/dist/registry/skills/cost-guardrails/generic.md

@@ -0,0 +1,23 @@
+## Cost Guardrails
+
+Before executing any large or multi-step operation, produce a brief cost estimate and require
+confirmation if the scope is significant.
+
+**Trigger automatically when:**
+- A task requires editing more than 5 files
+- A task requires generating more than ~500 lines of new code
+- A task involves rewriting an entire module or feature
+
+**Estimate format:**
+```
+Cost estimate:
+  Scope:         [X files, ~Y lines affected]
+  Input tokens:  ~[range] (estimate)
+  Output tokens: ~[range] (estimate)
+  Risk:          [none | low | medium | high]
+
+Proceed? [describe what will happen next]
+```
+
+Always label estimates as estimates. If the user says "yes" or "just do it", proceed without
+further prompts. Say "cost guardrails on" to activate. Say "cost guardrails off" to deactivate.

package/dist/registry/skills/patch-only/aider.yml

@@ -0,0 +1,4 @@
+# Patch-Only Coding — output only changed code, never rewrite entire files.
+# Preferred: unified diff > function replacement > line range with 3 lines context.
+# State why if full file regeneration is necessary.
+# Never output unchanged code as "context" — reference line numbers instead.

package/dist/registry/skills/patch-only/claude-code.md

@@ -0,0 +1,12 @@
+## Patch-Only Coding
+
+When editing existing code: output ONLY the changed portion. Never rewrite entire files unless
+creating a brand-new file.
+
+Preferred output formats (in order of preference):
+1. Unified diff  (--- a/file  +++ b/file)
+2. Function replacement  (show only the modified function with its signature)
+3. Line range  (changed lines + 3 lines of surrounding context)
+
+If the entire file must be regenerated, state why before outputting it.
+Never output unchanged code to "show context" — use line numbers instead.

package/dist/registry/skills/patch-only/copilot.md

@@ -0,0 +1,12 @@
+## Patch-Only Coding
+
+When editing existing code: output ONLY the changed portion. Never rewrite entire files unless
+creating a brand-new file.
+
+Preferred output formats (in order of preference):
+1. Unified diff  (--- a/file  +++ b/file)
+2. Function replacement  (show only the modified function with its signature)
+3. Line range  (changed lines + 3 lines of surrounding context)
+
+If the entire file must be regenerated, state why before outputting it.
+Never output unchanged code to "show context" — use line numbers instead.

package/dist/registry/skills/patch-only/cursor.md

@@ -0,0 +1,12 @@
+## Patch-Only Coding
+
+When editing existing code: output ONLY the changed portion. Never rewrite entire files unless
+creating a brand-new file.
+
+Preferred output formats (in order of preference):
+1. Unified diff  (--- a/file  +++ b/file)
+2. Function replacement  (show only the modified function with its signature)
+3. Line range  (changed lines + 3 lines of surrounding context)
+
+If the entire file must be regenerated, state why before outputting it.
+Never output unchanged code to "show context" — use line numbers instead.

package/dist/registry/skills/patch-only/windsurf.md

@@ -0,0 +1,12 @@
+## Patch-Only Coding
+
+When editing existing code: output ONLY the changed portion. Never rewrite entire files unless
+creating a brand-new file.
+
+Preferred output formats (in order of preference):
+1. Unified diff  (--- a/file  +++ b/file)
+2. Function replacement  (show only the modified function with its signature)
+3. Line range  (changed lines + 3 lines of surrounding context)
+
+If the entire file must be regenerated, state why before outputting it.
+Never output unchanged code to "show context" — use line numbers instead.

package/dist/registry/skills/planner-executor/aider.yml

@@ -0,0 +1,5 @@
+# Planner / Executor Split — two-phase workflow for non-trivial tasks.
+# PLAN phase: reason, produce structured plan (goal, files, steps, risk). No code yet.
+# EXECUTE phase: follow plan mechanically, output only diffs and confirmations.
+# Plan format — Goal / Affected files / Steps / Assumptions / Risk level.
+# Say "plan: [task]" to plan. Say "execute" to run. No re-explanation in execute phase.

package/dist/registry/skills/planner-executor/claude-code.md

@@ -0,0 +1,23 @@
+## Planner / Executor Split
+
+For non-trivial tasks, use two phases:
+
+**PLAN phase** — Reason about the problem. Produce a structured execution plan. Do not write
+code yet. Format:
+
+```
+Goal: [one sentence]
+Affected files: [list]
+Steps:
+  1. [atomic action]
+  2. [atomic action]
+Assumptions: [list]
+Risk: [none | low | medium | high] — [reason if non-trivial]
+```
+
+**EXECUTE phase** — Follow the plan mechanically. Do not re-explain reasoning already in the
+plan. Output only diffs/patches and brief confirmations per step.
+
+Trigger plan phase:    /plan [task description]
+Trigger execute phase: /execute
+Skip to execute:       /plan-and-execute [task] (produces plan + immediately executes it)

package/dist/registry/skills/planner-executor/copilot.md

@@ -0,0 +1,22 @@
+## Planner / Executor Split
+
+For non-trivial tasks, use two phases:
+
+**PLAN phase** — Reason about the problem. Produce a structured execution plan. Do not write
+code yet. Format:
+
+```
+Goal: [one sentence]
+Affected files: [list]
+Steps:
+  1. [atomic action]
+  2. [atomic action]
+Assumptions: [list]
+Risk: [none | low | medium | high] — [reason if non-trivial]
+```
+
+**EXECUTE phase** — Follow the plan mechanically. Do not re-explain reasoning already in the
+plan. Output only diffs/patches and brief confirmations per step.
+
+Say "plan: [task]" to trigger the plan phase.
+Say "execute" to run the plan.

package/dist/registry/skills/planner-executor/cursor.md

@@ -0,0 +1,22 @@
+## Planner / Executor Split
+
+For non-trivial tasks, use two phases:
+
+**PLAN phase** — Reason about the problem. Produce a structured execution plan. Do not write
+code yet. Format:
+
+```
+Goal: [one sentence]
+Affected files: [list]
+Steps:
+  1. [atomic action]
+  2. [atomic action]
+Assumptions: [list]
+Risk: [none | low | medium | high] — [reason if non-trivial]
+```
+
+**EXECUTE phase** — Follow the plan mechanically. Do not re-explain reasoning already in the
+plan. Output only diffs/patches and brief confirmations per step.
+
+Trigger plan phase:    @plan [task description]
+Trigger execute phase: @execute

package/dist/registry/skills/planner-executor/generic.md

@@ -0,0 +1,23 @@
+## Planner / Executor Split
+
+For non-trivial tasks, use two phases:
+
+**PLAN phase** — Reason about the problem. Produce a structured execution plan. Do not write
+code yet. Format:
+
+```
+Goal: [one sentence]
+Affected files: [list]
+Steps:
+  1. [atomic action]
+  2. [atomic action]
+Assumptions: [list]
+Risk: [none | low | medium | high] — [reason if non-trivial]
+```
+
+**EXECUTE phase** — Follow the plan mechanically. Do not re-explain reasoning already in the
+plan. Output only diffs/patches and brief confirmations per step.
+
+Say "plan: [task]" to trigger the plan phase.
+Say "execute" to run the plan.
+Say "plan and execute: [task]" to do both in sequence.

package/dist/registry/skills/planner-executor/windsurf.md

@@ -0,0 +1,22 @@
+## Planner / Executor Split
+
+For non-trivial tasks, use two phases:
+
+**PLAN phase** — Reason about the problem. Produce a structured execution plan. Do not write
+code yet. Format:
+
+```
+Goal: [one sentence]
+Affected files: [list]
+Steps:
+  1. [atomic action]
+  2. [atomic action]
+Assumptions: [list]
+Risk: [none | low | medium | high] — [reason if non-trivial]
+```
+
+**EXECUTE phase** — Follow the plan mechanically. Do not re-explain reasoning already in the
+plan. Output only diffs/patches and brief confirmations per step.
+
+Say "plan: [task]" to trigger the plan phase.
+Say "execute" to run the plan.

package/dist/registry/skills/repo-aware-context/aider.yml

@@ -0,0 +1,5 @@
+# Repo-Aware Minimal Context — progressive context loading, never load entire repos.
+# Order: project summary > relevant module > specific files > specific functions > solve.
+# Never pre-load files. Never include node_modules/lockfiles/build outputs.
+# Trim logs to error block + 10 lines. Follow imports one hop only.
+# Reference line numbers instead of quoting unchanged code.

package/dist/registry/skills/repo-aware-context/claude-code.md

@@ -0,0 +1,23 @@
+## Repo-Aware Minimal Context
+
+Load context progressively. Never pull in more than what the current task requires.
+
+**Loading order (strict):**
+1. Project summary (project_summary.md if present, else README first 50 lines)
+2. Relevant module (the folder containing the files being changed)
+3. Specific files (only files directly referenced by the task)
+4. Specific functions (patch-level — not entire files if only one function changes)
+5. Solve
+
+**Rules:**
+- Never read entire repositories unless explicitly asked
+- Never pre-load files "just in case" — wait until they are needed
+- Never include node_modules, lockfiles, build outputs, or generated files
+- Trim log files to: last error block + 10 lines of surrounding context
+- For imports: only follow one hop (direct dependencies of changed file, not transitive)
+- Reference line numbers instead of quoting unchanged code for context
+
+**When you need more context:** say exactly what file and what section you need, and why.
+Do not silently load it — state the request so the user can confirm or redirect.
+
+Activate with: /minimal-context or "minimal context mode"

package/dist/registry/skills/repo-aware-context/generic.md

@@ -0,0 +1,21 @@
+## Repo-Aware Minimal Context
+
+Load context progressively. Never pull in more than what the current task requires.
+
+**Loading order (strict):**
+1. Project summary (project_summary.md if present, else README first 50 lines)
+2. Relevant module (the folder containing the files being changed)
+3. Specific files (only files directly referenced by the task)
+4. Specific functions (patch-level — not entire files if only one function changes)
+5. Solve
+
+**Rules:**
+- Never read entire repositories unless explicitly asked
+- Never pre-load files "just in case" — wait until they are needed
+- Never include node_modules, lockfiles, build outputs, or generated files
+- Trim log files to: last error block + 10 lines of surrounding context
+- For imports: only follow one hop (direct dependencies of changed file, not transitive)
+- Reference line numbers instead of quoting unchanged code for context
+
+**When you need more context:** state exactly what file and what section you need, and why.
+Say "minimal context mode" to activate this skill.