lint: add skillsaw job that lints

.github/workflows/skillsaw.yml

@@ -0,0 +1,21 @@
+name: Skillsaw
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    name: Skill Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Run skillsaw
+        # skillsaw v0 (0.15.0)
+        uses: stbenjam/skillsaw@1bf34517f8c38193814a0ff7199d028897fbf344
+        with:
+          strict: false

.skillsaw.yaml

@@ -0,0 +1,11 @@
+version: "0.15.0"
+
+rules:
+  context-budget:
+    limits:
+      skill:
+        warn: 8000
+        error: 16000
+  content-critical-position:
+    exclude:
+      - "plugins/sdlc-workflow/skills/plan-feature/SKILL.md"

CLAUDE.md

@@ -15,8 +15,8 @@
 
 The plugin version must be kept in sync in two files:
 
-- `plugins/sdlc-workflow/.claude-plugin/plugin.json` — the plugin manifest (required by CI validation)
-- `.claude-plugin/marketplace.json` — the marketplace registry (required for relative-path plugins per Claude Code docs)
+- [`plugins/sdlc-workflow/.claude-plugin/plugin.json`](plugins/sdlc-workflow/.claude-plugin/plugin.json) — the plugin manifest (required by CI validation)
+- [`.claude-plugin/marketplace.json`](.claude-plugin/marketplace.json) — the marketplace registry (required for relative-path plugins per Claude Code docs)
 
 When bumping the version, update both files together.
 
@@ -47,7 +47,7 @@ No limitations known — no Serena instances configured.
 ## Bug Configuration
 
 - Bug issue type ID: 10016
-- Bug template: docs/templates/bug-template.md
+- Bug template: [docs/templates/bug-template.md](docs/templates/bug-template.md)
 - Bug-to-Task link type: Blocks
 
 ## Hierarchy Configuration

plugins/sdlc-workflow/skills/plan-feature/SKILL.md

@@ -633,7 +633,7 @@ Before generating task descriptions, read `docs/constraints.md` from the project
 - For tasks that create Jira issues: include the task template rules (§4).
 - For all tasks: include the skill scope rules (§1) that apply to the skill executing the task.
 
-Create implementation tasks for each unit of work. Each task description MUST follow the template defined in [`shared/task-description-template.md`](../shared/task-description-template.md) exactly — read the template and rules from that file before generating tasks.
+Create implementation tasks for each unit of work. Each task description MUST follow the template defined in [`shared/task-description-template.md`](../../shared/task-description-template.md) exactly — read the template and rules from that file before generating tasks.
 
 ### Epic grouping (when available)
 
@@ -856,7 +856,7 @@ proceeding. Convention enrichment is not optional when conventions exist.
 ### Eval coverage propagation
 
 For each task, apply the eval coverage propagation from
-[`shared/eval-coverage-propagation.md`](../shared/eval-coverage-propagation.md).
+[`shared/eval-coverage-propagation.md`](../../shared/eval-coverage-propagation.md).
 
 ### Backend API contract enrichment for manual REST calls
 

plugins/sdlc-workflow/skills/triage-bug/SKILL.md

@@ -342,7 +342,7 @@ jira.add_comment(<jira-bug-id>, <root-cause-analysis>)
 ## Step 5 – Generate Task
 
 Create a single Task issue following
-[`shared/task-description-template.md`](../shared/task-description-template.md).
+[`shared/task-description-template.md`](../../shared/task-description-template.md).
 Read the template before generating the task description.
 
 ### Front-load the reproducer test

plugins/sdlc-workflow/skills/verify-pr/SKILL.md

@@ -489,9 +489,9 @@ jira.create_issue with:
 - **Summary:** concise description of the required fix
 - **Labels:** `["ai-generated-jira", "review-feedback"]`
 - **Description:** structured task description following the template defined in
-  [`shared/task-description-template.md`](../shared/task-description-template.md).
+  [`shared/task-description-template.md`](../../shared/task-description-template.md).
   Apply the eval coverage propagation from
-  [`shared/eval-coverage-propagation.md`](../shared/eval-coverage-propagation.md).
+  [`shared/eval-coverage-propagation.md`](../../shared/eval-coverage-propagation.md).
   Include the applicable base sections plus these extension sections:
 
   - **Review Context** — the original review comment text and PR file/line reference
@@ -518,7 +518,7 @@ Process `create-sub-task` actions from the Correctness sub-agent. For each actio
    - **Summary:** the action's Title (e.g., "Fix failing lint check: unused import in handler.rs")
    - **Labels:** `["ai-generated-jira", "review-feedback"]`
    - **Description:** structured task description following the template defined in
-     [`shared/task-description-template.md`](../shared/task-description-template.md).
+     [`shared/task-description-template.md`](../../shared/task-description-template.md).
      Include:
      - **Review Context** — the CI check name, failure log excerpt, and error summary
        (from the action's Root cause field)
@@ -560,7 +560,7 @@ and sub-task creation below.
    - **Summary:** "Fix <eval-id> assertion failures: <brief description of failures>"
    - **Labels:** `["ai-generated-jira", "eval-failure"]`
    - **Description:** structured task description following the template defined in
-     [`shared/task-description-template.md`](../shared/task-description-template.md).
+     [`shared/task-description-template.md`](../../shared/task-description-template.md).
      Include:
      - **Review Context** — the eval review body excerpt with specific failing
        assertions and their evidence (text + evidence fields from the eval review)
@@ -829,9 +829,9 @@ jira.create_issue with:
 - **Summary:** "Root-cause: <brief description of the systemic improvement>"
 - **Labels:** `["ai-generated-jira", "root-cause"]`
 - **Description:** structured task description following the template defined in
-  [`shared/task-description-template.md`](../shared/task-description-template.md).
+  [`shared/task-description-template.md`](../../shared/task-description-template.md).
   Apply the eval coverage propagation from
-  [`shared/eval-coverage-propagation.md`](../shared/eval-coverage-propagation.md).
+  [`shared/eval-coverage-propagation.md`](../../shared/eval-coverage-propagation.md).
   The description must be actionable — it describes the concrete change to the
   skill, prompt, or convention that prevents the gap from recurring. Do **not**
   include the root-cause analysis narrative in the description.