# Block

> Block

- Skill: `kv0906/block` (Agent Skill)
- Install (CLI): `npx skillmds@latest add kv0906/block`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kv0906/block/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kv0906 (https://skillmd.com/u/kv0906)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kv0906/block

---


# /block — Flag Blocker

Create or update blocker notes with severity, owner, and due date.

## Context

Today's date: `!date +%Y-%m-%d`
Existing blockers: `!ls blockers/*/*.md 2>/dev/null | tail -10`

Reference template: @_templates/blocker.md
Config: @_core/config.yaml
Processing logic: @_core/PROCESSING.md

## Input

User input: $ARGUMENTS

## Processing Steps

1. **Parse Input**
   - Extract project (before colon)
   - Extract description
   - Parse flags: --severity, --owner, --due
   - Default severity: medium

2. **Severity Mapping**
   - critical/urgent/p0/p1 → high
   - medium/normal/p2 → medium
   - low/minor/p3 → low

3. **Duplicate Check**
   - Search `blockers/{project}/*.md` for similar open blockers
   - If similar found: Prompt user to update existing or create new

4. **Create Blocker Note**
   - Filename: `blockers/{project}/{date}-{slug}.md`
   - Apply template with extracted data
   - Add `## Links` section

5. **Update References**
   - Add to project index if exists
   - If critical (high severity + due < 2 days): Flag for escalation

6. **Append to Vault Log**
   - Append entry to `01-index/_vault-log.md` (see `.claude/rules/vault-log.md`)
   - Action: `blocker`
   - Details: severity, owner, one-line description

## Output

```
Created: blockers/{project}/{date}-{slug}.md
Severity: {severity} | Owner: {owner} | Due: {due}
```

## Export (Optional)

Supports `--xlsx` flag. See `.claude/rules/export-formats.md` for layout specs and workflow. Complete normal processing first, then generate the formatted file.