diff --git a/plugins/corbits-skills/skills/ast-grep/SKILL.md b/plugins/corbits-skills/skills/ast-grep/SKILL.md index 109e70830..8dbe8d7b9 100644 --- a/plugins/corbits-skills/skills/ast-grep/SKILL.md +++ b/plugins/corbits-skills/skills/ast-grep/SKILL.md @@ -1,6 +1,6 @@ --- name: ast-grep -description: Bulk code refactoring using AST patterns instead of manual read-edit-write cycles. Load this skill when renaming, changing signatures, or migrating API usage across many files. +description: Bulk refactors with AST patterns. Load for renames and API migrations across many files. --- # ast-grep diff --git a/plugins/corbits-skills/skills/create-issue/SKILL.md b/plugins/corbits-skills/skills/create-issue/SKILL.md index fc42b94ae..ecc506cbe 100644 --- a/plugins/corbits-skills/skills/create-issue/SKILL.md +++ b/plugins/corbits-skills/skills/create-issue/SKILL.md @@ -1,6 +1,6 @@ --- name: create-issue -description: Create well-structured issues. Linear MCP if available; otherwise ask for GitHub (or another tracker) and remember the preference. +description: Create a structured issue in Linear, GitHub, or GitLab. argument-hint: "[description] [--from-doc]" --- diff --git a/plugins/corbits-skills/skills/git-rebase/SKILL.md b/plugins/corbits-skills/skills/git-rebase/SKILL.md index 88282d61e..03126c5da 100644 --- a/plugins/corbits-skills/skills/git-rebase/SKILL.md +++ b/plugins/corbits-skills/skills/git-rebase/SKILL.md @@ -1,6 +1,6 @@ --- name: git-rebase -description: Reshape git history with rebase — edit-in-place to fix an earlier commit, squash/fixup, drop, split, reword, or validate every replayed commit. Load whenever you need to change a commit that is not HEAD, or for any branch-history cleanup before push. Covers driving every editor invocation non-interactively so the rebase runs without a human at the keyboard. +description: Reshape branch history non-interactively with rebase, fixup, squash, drop, split, or reword. user-invocable: false --- diff --git a/plugins/corbits-skills/skills/git-worktrees/SKILL.md b/plugins/corbits-skills/skills/git-worktrees/SKILL.md index a4161826f..13c551062 100644 --- a/plugins/corbits-skills/skills/git-worktrees/SKILL.md +++ b/plugins/corbits-skills/skills/git-worktrees/SKILL.md @@ -2,7 +2,7 @@ name: git-worktrees user-invocable: false disable-model-invocation: true -description: Create a git worktree from origin/ and tear it down. Background library — load via use_skill("git-worktrees"); absent from slash and use_skill listing. +description: Create and tear down a worktree from origin/. Load via use_skill. --- # git-worktrees diff --git a/plugins/corbits-skills/skills/implement/SKILL.md b/plugins/corbits-skills/skills/implement/SKILL.md index 6b0a0e227..24f5ff5d0 100644 --- a/plugins/corbits-skills/skills/implement/SKILL.md +++ b/plugins/corbits-skills/skills/implement/SKILL.md @@ -1,6 +1,6 @@ --- name: implement -description: Disciplined per-commit workflow with Planner review, build gates, and Reviewer loops +description: Per-commit workflow with planner review, build gate, and reviewer loop. --- # Implement diff --git a/plugins/corbits-skills/skills/interview/SKILL.md b/plugins/corbits-skills/skills/interview/SKILL.md index 886743b8b..39a3d04fb 100644 --- a/plugins/corbits-skills/skills/interview/SKILL.md +++ b/plugins/corbits-skills/skills/interview/SKILL.md @@ -1,7 +1,7 @@ --- name: interview argument-hint: "[; ]" -description: Conduct an iterative multiple-choice interview using `ask_operator`. Returns the Q&A inline. Use as a utility when a caller needs structured user input on a topic. +description: Ask the operator batched multiple-choice questions and return the Q&A. --- # Interview diff --git a/plugins/corbits-skills/skills/lexicon/SKILL.md b/plugins/corbits-skills/skills/lexicon/SKILL.md index cc47eed5d..2b0187025 100644 --- a/plugins/corbits-skills/skills/lexicon/SKILL.md +++ b/plugins/corbits-skills/skills/lexicon/SKILL.md @@ -1,6 +1,6 @@ --- name: lexicon -description: Diff director prompts against the agents repo at a pinned commit, report assembled prompt sizes, and file Linear issues for drift +description: Diff director prompts against the agents repo at a pinned commit and file drift issues. argument-hint: "[--pin ] [--file-issues]" --- diff --git a/plugins/corbits-skills/skills/linear-issue-workflow/SKILL.md b/plugins/corbits-skills/skills/linear-issue-workflow/SKILL.md index e0188c30e..50513bb76 100644 --- a/plugins/corbits-skills/skills/linear-issue-workflow/SKILL.md +++ b/plugins/corbits-skills/skills/linear-issue-workflow/SKILL.md @@ -1,6 +1,6 @@ --- name: linear-issue-workflow -description: Implement a feature or fix based on a Linear issue +description: Ship a feature or fix from a Linear issue, from claim to reviewed PR. argument-hint: " [--reviewer ]" user-invocable: false --- diff --git a/plugins/corbits-skills/skills/opsh/SKILL.md b/plugins/corbits-skills/skills/opsh/SKILL.md index 4a6da22f3..8ae1ecc95 100644 --- a/plugins/corbits-skills/skills/opsh/SKILL.md +++ b/plugins/corbits-skills/skills/opsh/SKILL.md @@ -1,6 +1,6 @@ --- name: opsh -description: Write scripts using opsh and its built-in libraries. Load this skill when writing, reviewing, or debugging opsh scripts. +description: Write and debug opsh scripts and use its built-in libraries. user-invocable: false --- diff --git a/plugins/corbits-skills/skills/philosophy/SKILL.md b/plugins/corbits-skills/skills/philosophy/SKILL.md index fc9c85405..7c47dfaff 100644 --- a/plugins/corbits-skills/skills/philosophy/SKILL.md +++ b/plugins/corbits-skills/skills/philosophy/SKILL.md @@ -1,6 +1,6 @@ --- name: philosophy -description: Engineering philosophy and work culture principles. Load this skill when making architectural decisions or to understand the team's work principles. +description: Engineering principles. Load for architectural decisions. user-invocable: false --- diff --git a/plugins/corbits-skills/skills/plan/SKILL.md b/plugins/corbits-skills/skills/plan/SKILL.md index c7fc417a2..52239df8a 100644 --- a/plugins/corbits-skills/skills/plan/SKILL.md +++ b/plugins/corbits-skills/skills/plan/SKILL.md @@ -1,6 +1,6 @@ --- name: plan -description: Author an agent-proof eng change plan. Does not implement. Does not file tracker issues. +description: Author an eng change plan. Does not implement or file issues. --- # Plan diff --git a/plugins/corbits-skills/skills/pull-request-review/SKILL.md b/plugins/corbits-skills/skills/pull-request-review/SKILL.md index f58ed12cd..65efc7328 100644 --- a/plugins/corbits-skills/skills/pull-request-review/SKILL.md +++ b/plugins/corbits-skills/skills/pull-request-review/SKILL.md @@ -1,6 +1,6 @@ --- name: pull-request-review -description: Review a pull request by branch name or URL, using a git worktree +description: Review a pull request by branch or URL in a git worktree. --- # Pull Request Review diff --git a/plugins/corbits-skills/skills/refactor/SKILL.md b/plugins/corbits-skills/skills/refactor/SKILL.md index 16caa2a52..47dc7b83a 100644 --- a/plugins/corbits-skills/skills/refactor/SKILL.md +++ b/plugins/corbits-skills/skills/refactor/SKILL.md @@ -1,7 +1,7 @@ --- name: refactor argument-hint: -description: Examine code, document its design, and collaboratively plan improvements +description: Document a directory's design and plan improvements with the operator. --- # Refactor diff --git a/plugins/corbits-skills/skills/review/SKILL.md b/plugins/corbits-skills/skills/review/SKILL.md index 963c8b52b..239e10bc3 100644 --- a/plugins/corbits-skills/skills/review/SKILL.md +++ b/plugins/corbits-skills/skills/review/SKILL.md @@ -1,6 +1,6 @@ --- name: review -description: Perform a code review or pull request review on a branch +description: Review a branch or pull request diff and report findings. --- # Code Review diff --git a/plugins/corbits-skills/skills/scribe/SKILL.md b/plugins/corbits-skills/skills/scribe/SKILL.md index 230d20e0b..5de607edb 100644 --- a/plugins/corbits-skills/skills/scribe/SKILL.md +++ b/plugins/corbits-skills/skills/scribe/SKILL.md @@ -1,6 +1,6 @@ --- name: scribe -description: Maintain product, architecture, and implementation docs — routes input, detects gaps, and interviews for completeness +description: Maintain product, architecture, and implementation docs and detect gaps. --- # Scribe diff --git a/plugins/corbits-skills/skills/style/SKILL.md b/plugins/corbits-skills/skills/style/SKILL.md index c58484b67..d8f2c75fa 100644 --- a/plugins/corbits-skills/skills/style/SKILL.md +++ b/plugins/corbits-skills/skills/style/SKILL.md @@ -1,6 +1,6 @@ --- name: style -description: General coding conventions for clean, maintainable code. Always load this skill when writing or reviewing code in any language. +description: General coding conventions. Load when writing or reviewing code. user-invocable: false --- diff --git a/plugins/corbits-skills/skills/typescript/SKILL.md b/plugins/corbits-skills/skills/typescript/SKILL.md index 543e97fe0..befa94761 100644 --- a/plugins/corbits-skills/skills/typescript/SKILL.md +++ b/plugins/corbits-skills/skills/typescript/SKILL.md @@ -1,6 +1,6 @@ --- name: typescript -description: TypeScript-specific coding conventions and type system patterns. Always load this skill when writing or reviewing TypeScript code. +description: TypeScript conventions and type patterns. Load when writing TypeScript. user-invocable: false ---