fix: narrow markdownlint ignore and correct skill references in ship command

cursoragent · cursoragent · commit 48d9d4876ea6 · 2026-04-11T05:28:41.000Z
- .markdownlint-cli2.yaml: Replace overly broad .claude/commands/** ignore
  with specific list of 6 new lifecycle command files. This preserves
  full linting for pre-existing command files (push-pr.md, pr-review.md,
  validate-pr-description.md, etc.)

- .claude/commands/ship.md: Correct references to validate-pr-description
  and push-pr. These are slash commands (.claude/commands/*.md), not
  skills (.claude/skills/*/SKILL.md). Update instructions to use command
  invocation syntax instead of Skill tool references.
diff --git a/.claude/commands/ship.md b/.claude/commands/ship.md
@@ -6,7 +6,7 @@ argument-hint: [target-branch]
 
 @CLAUDE.md
 
-Invoke the pipeline-validator and validate-pr-description skills.
+Invoke the pipeline-validator skill.
 
 Ship the current branch: $ARGUMENTS
 
@@ -30,8 +30,8 @@ Pre-flight checks (all must pass):
 
 1. Run pre-flight checks (all 5 above)
 2. If any check fails: report what failed, why, and how to fix. Stop.
-3. If all pass: validate PR description (invoke validate-pr-description skill)
-4. Create PR via /push-pr delegation (invoke Skill tool with push-pr)
+3. If all pass: validate PR description (run /validate-pr-description command)
+4. Create PR via /push-pr command
 5. Report: what shipped, PR link, any warnings
 
 ## Output
diff --git a/.markdownlint-cli2.yaml b/.markdownlint-cli2.yaml
@@ -138,5 +138,11 @@ ignores:
   # HTML tags, violating MD033 and MD041. These are tool-managed metadata, not authored markdown.
   - "**/CLAUDE.md"
 
-  # Slash command files have YAML frontmatter, not headings. MD041 not applicable.
-  - ".claude/commands/**"
+  # New lifecycle command files have only YAML frontmatter, no H1 heading. MD041 not applicable.
+  # Only the 6 new lifecycle commands are excluded; other command files retain full linting.
+  - ".claude/commands/spec.md"
+  - ".claude/commands/plan.md"
+  - ".claude/commands/build.md"
+  - ".claude/commands/test.md"
+  - ".claude/commands/review.md"
+  - ".claude/commands/ship.md"
