$npx -y skills add kv0906/pm-kit --skill blockFlag a blocker with severity, owner, and due date. Checks for duplicates before creating. Use for "/block project: description --severity high --due friday".
| 1 | # /block — Flag Blocker |
| 2 | |
| 3 | Create or update blocker notes with severity, owner, and due date. |
| 4 | |
| 5 | ## Context |
| 6 | |
| 7 | Today's date: `!date +%Y-%m-%d` |
| 8 | Existing blockers: `!ls blockers/*/*.md 2>/dev/null | tail -10` |
| 9 | |
| 10 | Reference template: @_templates/blocker.md |
| 11 | Config: @_core/config.yaml |
| 12 | Processing logic: @_core/PROCESSING.md |
| 13 | |
| 14 | ## Input |
| 15 | |
| 16 | User input: $ARGUMENTS |
| 17 | |
| 18 | ## Processing Steps |
| 19 | |
| 20 | 1. **Parse Input** |
| 21 | - Extract project (before colon) |
| 22 | - Extract description |
| 23 | - Parse flags: --severity, --owner, --due |
| 24 | - Default severity: medium |
| 25 | |
| 26 | 2. **Severity Mapping** |
| 27 | - critical/urgent/p0/p1 → high |
| 28 | - medium/normal/p2 → medium |
| 29 | - low/minor/p3 → low |
| 30 | |
| 31 | 3. **Duplicate Check** |
| 32 | - Search `blockers/{project}/*.md` for similar open blockers |
| 33 | - If similar found: Prompt user to update existing or create new |
| 34 | |
| 35 | 4. **Create Blocker Note** |
| 36 | - Filename: `blockers/{project}/{date}-{slug}.md` |
| 37 | - Apply template with extracted data |
| 38 | - Add `## Links` section |
| 39 | |
| 40 | 5. **Update References** |
| 41 | - Add to project index if exists |
| 42 | - If critical (high severity + due < 2 days): Flag for escalation |
| 43 | |
| 44 | 6. **Append to Vault Log** |
| 45 | - Append entry to `01-index/_vault-log.md` (see `.claude/rules/vault-log.md`) |
| 46 | - Action: `blocker` |
| 47 | - Details: severity, owner, one-line description |
| 48 | |
| 49 | ## Output |
| 50 | |
| 51 | ``` |
| 52 | Created: blockers/{project}/{date}-{slug}.md |
| 53 | Severity: {severity} | Owner: {owner} | Due: {due} |
| 54 | ``` |
| 55 | |
| 56 | ## Export (Optional) |
| 57 | |
| 58 | Supports `--xlsx` flag. See `.claude/rules/export-formats.md` for layout specs and workflow. Complete normal processing first, then generate the formatted file. |