Skip to main content
skill CX Codex

w-clarify — Claude Code skill: what it does, how to install

The w-clarify Claude Code skill finds missing decisions that could block correct work. It checks the request against the project’s code and documentation first.

MIT 647 installs ★ 1 updated 2026-10-02

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add blockmatic-icebox/basilic-skills --skill w-clarify -a claude-code
Open on GitHub

What w-clarify does

w-clarify compares a request with the project’s code and documentation, then asks about gaps that could change the result. It looks through the README, relevant MDX files, and ADRs before raising questions.

The skill focuses on behavior, trust boundaries, and destructive operations. Reversible details are left out, and it proceeds with assumptions the user has already stated. Model-triggered invocation is disabled, so the agent will not start it on its own.

For a detailed decision-tree interview, the repository has w-grill; w-wayfinder is for unclear work that spans more than one session.

What it helps with

  • find missing requirements that block correct work
  • check whether the code or docs already answer a question
  • surface gaps in behavior or trust boundaries
  • skip questions about reversible details

Example prompts for the agent

  • Use w-clarify to find requirements that block this task.
  • Check the request against the README and code with w-clarify, then ask only the key questions.
  • Run w-clarify to look for gaps involving behavior or destructive operations.

How to install w-clarify

1Skills CLI (Vercel)

npx skills add blockmatic-icebox/basilic-skills --skill w-clarify -a claude-code

2Manually: put the files in place

~/.claude/skills/w-clarify/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/w-clarify/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about w-clarify

How do I install w-clarify in Claude Code?

Run npx skills add blockmatic-icebox/basilic-skills --skill w-clarify -a claude-code, then use ~/.claude/skills/w-clarify/SKILL.md.

What does w-clarify do?

It checks a request against the code, README, relevant MDX files, and ADRs. Then it asks about unresolved decisions that could prevent correct work.

How is w-clarify different from w-grill and w-wayfinder?

w-clarify limits questions to decisions that block the work. w-grill runs a detailed decision-tree interview, while w-wayfinder addresses unclear work that extends beyond one session.

Source text

SKILL.md · MIT
---
name: w-clarify
description: Resolve consequential missing requirements from inspected context.
disable-model-invocation: true
---

Ask only for decisions that block correct work. Stay inside the request. Do not invent product scope. A relentless design-tree interview is [grill](../w-grill/SKILL.md). Fog bigger than one session is [wayfinder](../w-wayfinder/SKILL.md).

1. Inspect code, README, and matching MDX/ADRs for answers that already exist.
2. List remaining consequential gaps (behavior, trust boundary, destructive ops). Skip reversible details.
3. Ask the smallest set of questions. Continue with stated assumptions when the user already covered them.

© blockmatic-icebox · MIT · blockmatic-icebox/basilic-skills

Similar skills

SKILL.md skills catalog →

From the same set45

The whole set →
w-api-docs The w-api-docs Claude Code skill refreshes API documentation from its source schema or routes. It steps in when an API change needs to be reflected in generated docs. CX Codex +1 647installs w-docs w-docs — a skill for Claude Code updates project docs after code or feature changes. It selects the docs layer that owns the change. CX Codex +1 647installs w-architecture The w-architecture Claude Code skill plans an implementation structure against a project's architecture docs and ADRs. It runs on requests to plan a change. CX Codex +1 647installs w-roadmap The w-roadmap Claude Code skill compares implementation with GitHub issues and related docs. Invoke it explicitly to see which items are shipped, partial, or missing. CX Codex +1 647installs w-deslop The w-deslop Claude Code skill removes AI-generated noise from branch changes compared with main. It checks comments, defensive code, and any casts. CX Codex +1 647installs w-coderabbit The w-coderabbit Claude Code skill fetches CodeRabbit feedback on a PR or uncommitted diff. It applies clear fixes, then runs local checks. CX Codex +1 647installs w-release w-release is a Claude Code skill that reviews release impact, changelog changes, and template contracts. Invoke it manually; automatic invocation is disabled. CX Codex +1 647installs w-security w-security is a Claude Code skill that checks code changes or a repository tree against its security docs and existing checks. Run it to review a change for security defects. CX Codex +1 647installs

Project sponsors

Companies that keep this analytics open