From 5aeba625b969aea51166974fc818d446e1da649c Mon Sep 17 00:00:00 2001 From: kernel-public-sync Date: Mon, 20 Jul 2026 13:46:22 +0000 Subject: [PATCH] chore: sync public export --- .github/copilot-instructions.md | 14 ++++++ .github/instructions/review.instructions.md | 15 ++++++ .github/instructions/testing.instructions.md | 13 +++++ .github/skills/accessibility-scout/SKILL.md | 47 ++++++++++++++++++ .github/skills/adapter-compiler/SKILL.md | 47 ++++++++++++++++++ .github/skills/adr-capture/SKILL.md | 48 ++++++++++++++++++ .github/skills/agent-scheduler/SKILL.md | 47 ++++++++++++++++++ .github/skills/api-contract-guardian/SKILL.md | 47 ++++++++++++++++++ .github/skills/context-router/SKILL.md | 48 ++++++++++++++++++ .github/skills/debug-probe/SKILL.md | 48 ++++++++++++++++++ .github/skills/dependency-sentinel/SKILL.md | 47 ++++++++++++++++++ .github/skills/design-critic/SKILL.md | 48 ++++++++++++++++++ .github/skills/diff-surgeon/SKILL.md | 48 ++++++++++++++++++ .github/skills/docs-sync/SKILL.md | 46 +++++++++++++++++ .github/skills/evidence-ledger/SKILL.md | 48 ++++++++++++++++++ .github/skills/handoff-packet/SKILL.md | 48 ++++++++++++++++++ .github/skills/invariant-harvester/SKILL.md | 48 ++++++++++++++++++ .github/skills/kernel-core/SKILL.md | 48 ++++++++++++++++++ .github/skills/memory-gc/SKILL.md | 46 +++++++++++++++++ .github/skills/mistake-miner/SKILL.md | 46 +++++++++++++++++ .github/skills/perf-budget/SKILL.md | 46 +++++++++++++++++ .github/skills/policy-gate/SKILL.md | 46 +++++++++++++++++ .github/skills/pr-narrator/SKILL.md | 47 ++++++++++++++++++ .github/skills/prompt-to-skill/SKILL.md | 48 ++++++++++++++++++ .github/skills/release-captain/SKILL.md | 47 ++++++++++++++++++ .github/skills/repo-cartographer/SKILL.md | 49 +++++++++++++++++++ .github/skills/reproducer-forge/SKILL.md | 47 ++++++++++++++++++ .github/skills/review-bot-judge/SKILL.md | 46 +++++++++++++++++ .github/skills/risk-map/SKILL.md | 47 ++++++++++++++++++ .github/skills/security-tripwire/SKILL.md | 46 +++++++++++++++++ .github/skills/skill-evaluator/SKILL.md | 47 ++++++++++++++++++ .../skills/stale-context-detector/SKILL.md | 47 ++++++++++++++++++ .github/skills/task-contract/SKILL.md | 48 ++++++++++++++++++ .../skills/team-conventions-miner/SKILL.md | 47 ++++++++++++++++++ .github/skills/test-scout/SKILL.md | 47 ++++++++++++++++++ .github/skills/trigger-linter/SKILL.md | 47 ++++++++++++++++++ .github/skills/ui-verifier/SKILL.md | 46 +++++++++++++++++ .github/skills/verify-lattice/SKILL.md | 48 ++++++++++++++++++ .github/skills/worktree-orchestrator/SKILL.md | 47 ++++++++++++++++++ package.json | 1 + 40 files changed, 1741 insertions(+) create mode 100644 .github/copilot-instructions.md create mode 100644 .github/instructions/review.instructions.md create mode 100644 .github/instructions/testing.instructions.md create mode 100644 .github/skills/accessibility-scout/SKILL.md create mode 100644 .github/skills/adapter-compiler/SKILL.md create mode 100644 .github/skills/adr-capture/SKILL.md create mode 100644 .github/skills/agent-scheduler/SKILL.md create mode 100644 .github/skills/api-contract-guardian/SKILL.md create mode 100644 .github/skills/context-router/SKILL.md create mode 100644 .github/skills/debug-probe/SKILL.md create mode 100644 .github/skills/dependency-sentinel/SKILL.md create mode 100644 .github/skills/design-critic/SKILL.md create mode 100644 .github/skills/diff-surgeon/SKILL.md create mode 100644 .github/skills/docs-sync/SKILL.md create mode 100644 .github/skills/evidence-ledger/SKILL.md create mode 100644 .github/skills/handoff-packet/SKILL.md create mode 100644 .github/skills/invariant-harvester/SKILL.md create mode 100644 .github/skills/kernel-core/SKILL.md create mode 100644 .github/skills/memory-gc/SKILL.md create mode 100644 .github/skills/mistake-miner/SKILL.md create mode 100644 .github/skills/perf-budget/SKILL.md create mode 100644 .github/skills/policy-gate/SKILL.md create mode 100644 .github/skills/pr-narrator/SKILL.md create mode 100644 .github/skills/prompt-to-skill/SKILL.md create mode 100644 .github/skills/release-captain/SKILL.md create mode 100644 .github/skills/repo-cartographer/SKILL.md create mode 100644 .github/skills/reproducer-forge/SKILL.md create mode 100644 .github/skills/review-bot-judge/SKILL.md create mode 100644 .github/skills/risk-map/SKILL.md create mode 100644 .github/skills/security-tripwire/SKILL.md create mode 100644 .github/skills/skill-evaluator/SKILL.md create mode 100644 .github/skills/stale-context-detector/SKILL.md create mode 100644 .github/skills/task-contract/SKILL.md create mode 100644 .github/skills/team-conventions-miner/SKILL.md create mode 100644 .github/skills/test-scout/SKILL.md create mode 100644 .github/skills/trigger-linter/SKILL.md create mode 100644 .github/skills/ui-verifier/SKILL.md create mode 100644 .github/skills/verify-lattice/SKILL.md create mode 100644 .github/skills/worktree-orchestrator/SKILL.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 0000000..4db9d79 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,14 @@ + + +# GitHub Copilot Instructions + +This repository uses **Kernel** for repo-local agent quality artifacts. + +Project: kernel-skills + +Before non-trivial changes, inspect `.agent/kernel.yaml` and `.agent/state/current-task.md`. +Record verification in `.agent/evidence/` before claiming completion. + + + + diff --git a/.github/instructions/review.instructions.md b/.github/instructions/review.instructions.md new file mode 100644 index 0000000..99667da --- /dev/null +++ b/.github/instructions/review.instructions.md @@ -0,0 +1,15 @@ + + +# Kernel Review Instructions + +Review agent changes in kernel-skills against Kernel artifacts. + +Prime directive: No contract, no implementation. No evidence, no completion. No handoff, no continuity. + +- Confirm the task contract matches the diff. +- Confirm verification evidence supports completion claims. +- Focus on high-risk paths, generated outputs, and missing tests. + + + + diff --git a/.github/instructions/testing.instructions.md b/.github/instructions/testing.instructions.md new file mode 100644 index 0000000..484906f --- /dev/null +++ b/.github/instructions/testing.instructions.md @@ -0,0 +1,13 @@ + + +# Kernel Testing Instructions + +Use Kernel verification evidence for kernel-skills. + +- Prefer targeted tests for local behavior changes. +- Run project-level checks for refactors and broad changes. +- Record skipped checks and remaining risks in `.agent/evidence/`. + + + + diff --git a/.github/skills/accessibility-scout/SKILL.md b/.github/skills/accessibility-scout/SKILL.md new file mode 100644 index 0000000..d6b2ade --- /dev/null +++ b/.github/skills/accessibility-scout/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: accessibility-scout +description: "Use for UI changes. Reviews keyboard, focus, semantic HTML, labels, contrast, and ARIA. Do not trigger it for unrelated work just because the skill exists." +--- +# accessibility-scout + +## Purpose + +Use for UI changes. Reviews keyboard, focus, semantic HTML, labels, contrast, and ARIA. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Check keyboard path. +2. Check focus states. +3. Check labels. +4. Avoid ARIA misuse. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/adapter-compiler/SKILL.md b/.github/skills/adapter-compiler/SKILL.md new file mode 100644 index 0000000..71227bd --- /dev/null +++ b/.github/skills/adapter-compiler/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: adapter-compiler +description: "Use when generating ADE-specific files from canonical Kernel source. Do not trigger it for unrelated work just because the skill exists." +--- +# adapter-compiler + +## Purpose + +Use when generating ADE-specific files from canonical Kernel source. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Read `.agent/kernel.yaml`. +2. Generate adapter outputs. +3. Preserve manual sections. +4. Validate freshness. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/adr-capture/SKILL.md b/.github/skills/adr-capture/SKILL.md new file mode 100644 index 0000000..8f7a88c --- /dev/null +++ b/.github/skills/adr-capture/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: adr-capture +description: "Use when an architectural decision or durable tradeoff is made. Do not trigger it for unrelated work just because the skill exists." +--- +# adr-capture + +## Purpose + +Use when an architectural decision or durable tradeoff is made. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Record context. +2. Record decision. +3. Record alternatives. +4. Record consequences. +5. Record follow-up. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/agent-scheduler/SKILL.md b/.github/skills/agent-scheduler/SKILL.md new file mode 100644 index 0000000..fa47b00 --- /dev/null +++ b/.github/skills/agent-scheduler/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: agent-scheduler +description: "Use when a plan has multiple tasks. Decides serial vs parallel execution. Do not trigger it for unrelated work just because the skill exists." +--- +# agent-scheduler + +## Purpose + +Use when a plan has multiple tasks. Decides serial vs parallel execution. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Classify dependencies. +2. Identify path collisions. +3. Split safe tasks. +4. Sequence risky tasks. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/api-contract-guardian/SKILL.md b/.github/skills/api-contract-guardian/SKILL.md new file mode 100644 index 0000000..f66fbc7 --- /dev/null +++ b/.github/skills/api-contract-guardian/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: api-contract-guardian +description: "Use when changing APIs, SDKs, CLIs, config, schemas, events, migrations, or public types. Do not trigger it for unrelated work just because the skill exists." +--- +# api-contract-guardian + +## Purpose + +Use when changing APIs, SDKs, CLIs, config, schemas, events, migrations, or public types. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Detect public contract changes. +2. Check backward compatibility. +3. Require docs/changelog updates. +4. Require contract tests. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/context-router/SKILL.md b/.github/skills/context-router/SKILL.md new file mode 100644 index 0000000..8e2d8ed --- /dev/null +++ b/.github/skills/context-router/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: context-router +description: "Use before planning or coding. Builds a curated context bundle from repo maps, changed files, tests, docs, imports, and task contract. Do not trigger it for unrelated work just because the skill exists." +--- +# context-router + +## Purpose + +Use before planning or coding. Builds a curated context bundle from repo maps, changed files, tests, docs, imports, and task contract. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Identify relevant files. +2. Identify relevant tests and commands. +3. Identify docs and constraints. +4. Explicitly exclude likely irrelevant context. +5. Record bundle in `.agent/state/context-bundle.md`. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/debug-probe/SKILL.md b/.github/skills/debug-probe/SKILL.md new file mode 100644 index 0000000..0205c9f --- /dev/null +++ b/.github/skills/debug-probe/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: debug-probe +description: "Use for bugs, flaky tests, incidents, failing commands, or unclear behavior. Establishes causality before fixes. Do not trigger it for unrelated work just because the skill exists." +--- +# debug-probe + +## Purpose + +Use for bugs, flaky tests, incidents, failing commands, or unclear behavior. Establishes causality before fixes. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Reproduce symptom. +2. Create causal graph. +3. Localize boundary. +4. Add probe. +5. Avoid fixes before evidence. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/dependency-sentinel/SKILL.md b/.github/skills/dependency-sentinel/SKILL.md new file mode 100644 index 0000000..022245c --- /dev/null +++ b/.github/skills/dependency-sentinel/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: dependency-sentinel +description: "Use when manifests or lockfiles change. Analyzes dependency upgrade risk. Do not trigger it for unrelated work just because the skill exists." +--- +# dependency-sentinel + +## Purpose + +Use when manifests or lockfiles change. Analyzes dependency upgrade risk. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Classify direct/transitive. +2. Assess semver risk. +3. Identify affected imports. +4. Recommend verification. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/design-critic/SKILL.md b/.github/skills/design-critic/SKILL.md new file mode 100644 index 0000000..12757d9 --- /dev/null +++ b/.github/skills/design-critic/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: design-critic +description: "Use after a proposed plan and before implementation. Performs adversarial review of assumptions, complexity, failure modes, and simpler alternatives. Do not trigger it for unrelated work just because the skill exists." +--- +# design-critic + +## Purpose + +Use after a proposed plan and before implementation. Performs adversarial review of assumptions, complexity, failure modes, and simpler alternatives. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Attack assumptions. +2. Find missing edge cases. +3. Suggest simpler design. +4. Identify rollback concerns. +5. Approve, revise, or reject plan. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/diff-surgeon/SKILL.md b/.github/skills/diff-surgeon/SKILL.md new file mode 100644 index 0000000..4a5f9d4 --- /dev/null +++ b/.github/skills/diff-surgeon/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: diff-surgeon +description: "Use after code changes for surgical fixes, hotfixes, and high-risk work. Enforces minimal, relevant diffs. Do not trigger it for unrelated work just because the skill exists." +--- +# diff-surgeon + +## Purpose + +Use after code changes for surgical fixes, hotfixes, and high-risk work. Enforces minimal, relevant diffs. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Find unrelated changes. +2. Find broad rewrites. +3. Check public behavior changes. +4. Suggest smaller patch. +5. Record diff surgery report. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/docs-sync/SKILL.md b/.github/skills/docs-sync/SKILL.md new file mode 100644 index 0000000..81e36d3 --- /dev/null +++ b/.github/skills/docs-sync/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: docs-sync +description: "Use after behavior, API, config, command, or user-facing changes. Do not trigger it for unrelated work just because the skill exists." +--- +# docs-sync + +## Purpose + +Use after behavior, API, config, command, or user-facing changes. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Find docs likely affected. +2. Suggest updates. +3. Record docs intentionally unchanged. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/evidence-ledger/SKILL.md b/.github/skills/evidence-ledger/SKILL.md new file mode 100644 index 0000000..7b1a4db --- /dev/null +++ b/.github/skills/evidence-ledger/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: evidence-ledger +description: "Use after implementation, debugging, review, or release. Records claims and proof. Do not trigger it for unrelated work just because the skill exists." +--- +# evidence-ledger + +## Purpose + +Use after implementation, debugging, review, or release. Records claims and proof. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Record commands. +2. Record exit codes. +3. Record tests and screenshots. +4. Record failures before fixes when applicable. +5. Record remaining risks. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/handoff-packet/SKILL.md b/.github/skills/handoff-packet/SKILL.md new file mode 100644 index 0000000..fc057f7 --- /dev/null +++ b/.github/skills/handoff-packet/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: handoff-packet +description: "Use when switching ADEs, ending a long session, pausing incomplete work, or before another agent continues. Do not trigger it for unrelated work just because the skill exists." +--- +# handoff-packet + +## Purpose + +Use when switching ADEs, ending a long session, pausing incomplete work, or before another agent continues. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Summarize task. +2. List changed files. +3. List commands run. +4. List known failures. +5. List next actions and do-not-repeat notes. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/invariant-harvester/SKILL.md b/.github/skills/invariant-harvester/SKILL.md new file mode 100644 index 0000000..9618738 --- /dev/null +++ b/.github/skills/invariant-harvester/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: invariant-harvester +description: "Use before refactors, migrations, bug fixes, and public contract changes. Extracts behavior that must remain true. Do not trigger it for unrelated work just because the skill exists." +--- +# invariant-harvester + +## Purpose + +Use before refactors, migrations, bug fixes, and public contract changes. Extracts behavior that must remain true. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Inspect tests/docs/types. +2. List public contracts. +3. List tacit behavior. +4. Mark invariants as hard or soft. +5. Link invariants to verification. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/kernel-core/SKILL.md b/.github/skills/kernel-core/SKILL.md new file mode 100644 index 0000000..0cd0119 --- /dev/null +++ b/.github/skills/kernel-core/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: kernel-core +description: "Use before and after any non-trivial coding-agent task. Creates or updates a task contract, identifies relevant context, selects quality gates, requires evidence before completion, and writes a handoff packet when needed. Do not use for trivial one-line edits unless the touched area is high-risk." +--- +# kernel-core + +## Purpose + +Use before and after any non-trivial coding-agent task. Creates or updates a task contract, identifies relevant context, selects quality gates, requires evidence before completion, and writes a handoff packet when needed. Do not use for trivial one-line edits unless the touched area is high-risk. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Read or create `.agent/state/current-task.md`. +2. Classify task type and risk. +3. Route to relevant subskills. +4. Require evidence before completion. +5. Create handoff if context is long or work is incomplete. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/memory-gc/SKILL.md b/.github/skills/memory-gc/SKILL.md new file mode 100644 index 0000000..86851f2 --- /dev/null +++ b/.github/skills/memory-gc/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: memory-gc +description: "Use when agent instruction files or rules become bloated. Do not trigger it for unrelated work just because the skill exists." +--- +# memory-gc + +## Purpose + +Use when agent instruction files or rules become bloated. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Find duplicates. +2. Remove obsolete guidance. +3. Keep commands, constraints, verification, conventions. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/mistake-miner/SKILL.md b/.github/skills/mistake-miner/SKILL.md new file mode 100644 index 0000000..651e8e5 --- /dev/null +++ b/.github/skills/mistake-miner/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: mistake-miner +description: "Use after agent failure, bad review, reverted PR, repeated mistake, or process miss. Do not trigger it for unrelated work just because the skill exists." +--- +# mistake-miner + +## Purpose + +Use after agent failure, bad review, reverted PR, repeated mistake, or process miss. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Classify root process failure. +2. Propose rule/invariant/test/skill update. +3. Avoid adding vague rules. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/perf-budget/SKILL.md b/.github/skills/perf-budget/SKILL.md new file mode 100644 index 0000000..21d6621 --- /dev/null +++ b/.github/skills/perf-budget/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: perf-budget +description: "Use for hot paths, query changes, rendering, caching, bundle size, or loops. Do not trigger it for unrelated work just because the skill exists." +--- +# perf-budget + +## Purpose + +Use for hot paths, query changes, rendering, caching, bundle size, or loops. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Define budget. +2. Measure or reason explicitly. +3. Flag regressions. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/policy-gate/SKILL.md b/.github/skills/policy-gate/SKILL.md new file mode 100644 index 0000000..7acf37c --- /dev/null +++ b/.github/skills/policy-gate/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: policy-gate +description: "Use before destructive commands, dependency updates, migrations, deployment commands, force pushes, or critical path edits. Do not trigger it for unrelated work just because the skill exists." +--- +# policy-gate + +## Purpose + +Use before destructive commands, dependency updates, migrations, deployment commands, force pushes, or critical path edits. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Classify operation as safe/review/block. +2. Check path and command policy with `kernel policy check`. +3. Require explicit approval for review/block classes. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/pr-narrator/SKILL.md b/.github/skills/pr-narrator/SKILL.md new file mode 100644 index 0000000..2ecb480 --- /dev/null +++ b/.github/skills/pr-narrator/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: pr-narrator +description: "Use before opening or updating a PR. Produces reviewer-optimized summary, risk, verification, and rollback notes. Do not trigger it for unrelated work just because the skill exists." +--- +# pr-narrator + +## Purpose + +Use before opening or updating a PR. Produces reviewer-optimized summary, risk, verification, and rollback notes. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Summarize why and what changed. +2. List verification evidence. +3. Identify reviewer focus. +4. Include rollback plan. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/prompt-to-skill/SKILL.md b/.github/skills/prompt-to-skill/SKILL.md new file mode 100644 index 0000000..fa340ad --- /dev/null +++ b/.github/skills/prompt-to-skill/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: prompt-to-skill +description: "Use when a repeated prompt should become a reusable skill. Do not trigger it for unrelated work just because the skill exists." +--- +# prompt-to-skill + +## Purpose + +Use when a repeated prompt should become a reusable skill. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Extract trigger. +2. Define workflow. +3. Define output artifact. +4. Add tests. +5. Compile adapters. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/release-captain/SKILL.md b/.github/skills/release-captain/SKILL.md new file mode 100644 index 0000000..8cbb2c0 --- /dev/null +++ b/.github/skills/release-captain/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: release-captain +description: "Use for release prep, rollout, migration, or post-merge shipping. Do not trigger it for unrelated work just because the skill exists." +--- +# release-captain + +## Purpose + +Use for release prep, rollout, migration, or post-merge shipping. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Draft changelog. +2. Define rollout. +3. Define rollback. +4. Define post-release checks. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/repo-cartographer/SKILL.md b/.github/skills/repo-cartographer/SKILL.md new file mode 100644 index 0000000..e8b6618 --- /dev/null +++ b/.github/skills/repo-cartographer/SKILL.md @@ -0,0 +1,49 @@ + + +--- +name: repo-cartographer +description: "Use when initializing, onboarding, or exploring architecture, or during major refactors. Creates maps of repo topology, commands, entrypoints, tests, packages, and critical flows. Do not trigger it for unrelated work just because the skill exists." +--- +# repo-cartographer + +## Purpose + +Use when initializing, onboarding, or exploring architecture, or during major refactors. Creates maps of repo topology, commands, entrypoints, tests, packages, and critical flows. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Detect package manager and monorepo workspaces. +2. Map commands from package scripts, Makefile/justfile, and `kernel.yaml`. +3. Map entrypoints from root `package.json`. +4. Map test locations, frameworks, and config files. +5. Map subsystem boundaries and workspace packages. +6. Write `.agent/maps/repo.json` (version 2). + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/reproducer-forge/SKILL.md b/.github/skills/reproducer-forge/SKILL.md new file mode 100644 index 0000000..b63265a --- /dev/null +++ b/.github/skills/reproducer-forge/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: reproducer-forge +description: "Use for bug reports and flaky failures. Creates minimal reproducible cases. Do not trigger it for unrelated work just because the skill exists." +--- +# reproducer-forge + +## Purpose + +Use for bug reports and flaky failures. Creates minimal reproducible cases. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Minimize input. +2. Capture command/env/seed. +3. Create failing test where practical. +4. Document expected vs actual. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/review-bot-judge/SKILL.md b/.github/skills/review-bot-judge/SKILL.md new file mode 100644 index 0000000..4b5dcc0 --- /dev/null +++ b/.github/skills/review-bot-judge/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: review-bot-judge +description: "Use for pre-merge review. Reviews code against task contract, invariants, risks, and evidence. Do not trigger it for unrelated work just because the skill exists." +--- +# review-bot-judge + +## Purpose + +Use for pre-merge review. Reviews code against task contract, invariants, risks, and evidence. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Classify findings P0/P1/P2/nit. +2. Check correctness, security, performance, compatibility, tests, minimality. +3. Call out false-positive risk. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/risk-map/SKILL.md b/.github/skills/risk-map/SKILL.md new file mode 100644 index 0000000..123c542 --- /dev/null +++ b/.github/skills/risk-map/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: risk-map +description: "Use before editing high-impact code. Maps files and subsystems to blast radius and verification requirements. Do not trigger it for unrelated work just because the skill exists." +--- +# risk-map + +## Purpose + +Use before editing high-impact code. Maps files and subsystems to blast radius and verification requirements. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Identify high-risk paths from `.agent/maps/risk.json`. +2. Identify required checks. +3. Detect ownership from `risk.json` `ownership` entries (CODEOWNERS + config). +4. Escalate verification. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/security-tripwire/SKILL.md b/.github/skills/security-tripwire/SKILL.md new file mode 100644 index 0000000..a6f8eb5 --- /dev/null +++ b/.github/skills/security-tripwire/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: security-tripwire +description: "Use when touching auth, crypto, secrets, SQL, shell execution, file uploads, permissions, deserialization, webhooks, SSRF, or tenancy. Do not trigger it for unrelated work just because the skill exists." +--- +# security-tripwire + +## Purpose + +Use when touching auth, crypto, secrets, SQL, shell execution, file uploads, permissions, deserialization, webhooks, SSRF, or tenancy. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Apply targeted security checklist. +2. Identify vulnerability class. +3. Require security-specific verification. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/skill-evaluator/SKILL.md b/.github/skills/skill-evaluator/SKILL.md new file mode 100644 index 0000000..fb92415 --- /dev/null +++ b/.github/skills/skill-evaluator/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: skill-evaluator +description: "Use before releasing skill changes. Regression-tests skill triggers and outputs. Do not trigger it for unrelated work just because the skill exists." +--- +# skill-evaluator + +## Purpose + +Use before releasing skill changes. Regression-tests skill triggers and outputs. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Run prompt fixtures. +2. Check activation behavior. +3. Check output format. +4. Prevent regressions. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/stale-context-detector/SKILL.md b/.github/skills/stale-context-detector/SKILL.md new file mode 100644 index 0000000..cfca19d --- /dev/null +++ b/.github/skills/stale-context-detector/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: stale-context-detector +description: "Use after rebases, long sessions, branch changes, failing commands, or generated maps older than source. Do not trigger it for unrelated work just because the skill exists." +--- +# stale-context-detector + +## Purpose + +Use after rebases, long sessions, branch changes, failing commands, or generated maps older than source. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Check files changed since read. +2. Check branch state. +3. Check map age. +4. Require reread when stale. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/task-contract/SKILL.md b/.github/skills/task-contract/SKILL.md new file mode 100644 index 0000000..98923ca --- /dev/null +++ b/.github/skills/task-contract/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: task-contract +description: "Use before non-trivial coding, debugging, refactoring, migration, or review work. Converts vague requests into compact goals, non-goals, assumptions, risks, verification, and done criteria. Do not trigger it for unrelated work just because the skill exists." +--- +# task-contract + +## Purpose + +Use before non-trivial coding, debugging, refactoring, migration, or review work. Converts vague requests into compact goals, non-goals, assumptions, risks, verification, and done criteria. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Define task type. +2. Write observable goal. +3. Write non-goals. +4. List assumptions as confirmed or unconfirmed. +5. Define verification and done criteria. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/team-conventions-miner/SKILL.md b/.github/skills/team-conventions-miner/SKILL.md new file mode 100644 index 0000000..9181d3b --- /dev/null +++ b/.github/skills/team-conventions-miner/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: team-conventions-miner +description: "Use when onboarding or when repeated style mistakes appear. Infers conventions from code and history. Do not trigger it for unrelated work just because the skill exists." +--- +# team-conventions-miner + +## Purpose + +Use when onboarding or when repeated style mistakes appear. Infers conventions from code and history. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Sample code. +2. Infer style. +3. Assign confidence. +4. Propose durable rules. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/test-scout/SKILL.md b/.github/skills/test-scout/SKILL.md new file mode 100644 index 0000000..6882fea --- /dev/null +++ b/.github/skills/test-scout/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: test-scout +description: "Use before writing or running tests. Finds the cheapest meaningful verification surface. Do not trigger it for unrelated work just because the skill exists." +--- +# test-scout + +## Purpose + +Use before writing or running tests. Finds the cheapest meaningful verification surface. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Locate nearest tests. +2. Rank tests by relevance and cost. +3. Recommend targeted test path. +4. Identify missing regression test. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/trigger-linter/SKILL.md b/.github/skills/trigger-linter/SKILL.md new file mode 100644 index 0000000..111c2f8 --- /dev/null +++ b/.github/skills/trigger-linter/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: trigger-linter +description: "Use when writing or updating skills. Prevents vague or overbroad activation descriptions. Do not trigger it for unrelated work just because the skill exists." +--- +# trigger-linter + +## Purpose + +Use when writing or updating skills. Prevents vague or overbroad activation descriptions. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Check description specificity. +2. Find overlap. +3. Require do-not-use conditions. +4. Require measurable outputs. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/ui-verifier/SKILL.md b/.github/skills/ui-verifier/SKILL.md new file mode 100644 index 0000000..5e5068e --- /dev/null +++ b/.github/skills/ui-verifier/SKILL.md @@ -0,0 +1,46 @@ + + +--- +name: ui-verifier +description: "Use for UI, CSS, layout, component, or frontend behavior changes. Do not trigger it for unrelated work just because the skill exists." +--- +# ui-verifier + +## Purpose + +Use for UI, CSS, layout, component, or frontend behavior changes. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Require visual check. +2. Check states and responsive behavior. +3. Record screenshots when available. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/verify-lattice/SKILL.md b/.github/skills/verify-lattice/SKILL.md new file mode 100644 index 0000000..6219248 --- /dev/null +++ b/.github/skills/verify-lattice/SKILL.md @@ -0,0 +1,48 @@ + + +--- +name: verify-lattice +description: "Use before declaring completion. Selects and records the appropriate verification level for the task. Do not trigger it for unrelated work just because the skill exists." +--- +# verify-lattice + +## Purpose + +Use before declaring completion. Selects and records the appropriate verification level for the task. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Choose L0-L5 verification. +2. Run or request commands. +3. Record outputs. +4. Mark completion status. +5. List remaining risk. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/.github/skills/worktree-orchestrator/SKILL.md b/.github/skills/worktree-orchestrator/SKILL.md new file mode 100644 index 0000000..6ef4f9b --- /dev/null +++ b/.github/skills/worktree-orchestrator/SKILL.md @@ -0,0 +1,47 @@ + + +--- +name: worktree-orchestrator +description: "Use when parallel agent work or isolated branches are needed. Do not trigger it for unrelated work just because the skill exists." +--- +# worktree-orchestrator + +## Purpose + +Use when parallel agent work or isolated branches are needed. + +## Trigger + +Use this skill when its purpose matches the current task. Do not trigger it for unrelated work just because the skill exists. + +## Workflow + +1. Create worktree plan. +2. Lock paths. +3. Name branch. +4. Prevent collisions. + +## Output + +Write a concise artifact under `.agent/` when filesystem access is available. Otherwise, include the artifact in the agent response. + +## Quality bar + +- Be specific. +- Prefer observable facts over impressions. +- Record uncertainty explicitly. +- Avoid bloating global instruction files. +- Link output to the current task contract when applicable. + +## Related skills + +- [[kernel-core]] +- [[verify-lattice]] +- [[evidence-ledger]] +- [[handoff-packet]] + +## Manual notes + + + + diff --git a/package.json b/package.json index c194d34..a331e46 100644 --- a/package.json +++ b/package.json @@ -3,6 +3,7 @@ "version": "0.2.0", "description": "Kernel CLI: a repo-local quality system and portable operating layer for coding agents.", "type": "module", + "private": true, "license": "Apache-2.0", "repository": { "type": "git",