How does it handle multiple projects?

It is specifically designed to detect 'project mixing,' where a developer might be applying logic or implementation details from a different codebase to the current one.

What evidence does the skill provide in its explanation?

The skill structures its response by citing specific code snippets, configuration files, and documentation to explain exactly why the system is behaving the way it is.

Does this skill automatically fix my code?

No, its primary goal is to explain and clarify. If it identifies a genuine bug during its investigation, it will suggest entering Plan Mode to design a proper fix.

Is the tone of the skill suitable for senior developers?

Yes, it is designed to be helpful and non-condescending, acknowledging that even experienced developers can lose track of details when working across complex, multiple systems.

When does the Clarify skill activate?

It triggers automatically on phrases like 'I don't understand,' 'this doesn't make sense,' or 'I expected X but got Y,' as well as signals of user frustration.

Clarify & Align

Name: Clarify & Align
Author: umputun

byumputun

•

174

•

Productivity & Workflow

Resolves developer confusion by analyzing gaps between expected and actual behavior to determine if a system requires explanation or a code fix.

The Clarify skill is a specialized diagnostic tool for Claude Code designed to bridge the gap between user expectations and system reality. It automatically triggers when developers express confusion, frustration, or encounter unexpected behaviors, systematically investigating the codebase to provide evidence-based explanations. By distinguishing between simple memory lapses, project-context mixing, and genuine architectural bugs, it ensures that developers regain clarity quickly while maintaining a structured path toward fixing verified issues through Plan Mode. It serves as an intelligent 'rubber duck' that can verify the state of the system against the user's mental model.

Key Features

01Evidence-based investigation of code, configuration, and documentation

02Automated confusion detection based on natural language triggers

03Structured response format comparing expectations versus reality

04174 GitHub stars

05Context-aware analysis to identify project-mixing or outdated mental models

06Seamless transition to Plan Mode for verified implementation bugs

Use Cases

01Resolving 'it worked differently last time' moments when switching between multiple repositories

02Determining if an unexpected output is a intended feature, a documentation gap, or a functional bug

03Understanding why a specific configuration or design pattern was implemented in a certain way

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add umputun/cc-thingz clarify

For use in Claude.ai and ChatGPT

Download Skill