# Clearthought

> Structured reasoning for complex coding work. Use when requirements are ambiguous, a design/debugging decision has multiple valid paths, or a large request needs to be split into safe implementable tasks.

- **Type:** Skill
- **Install:** `agentstack add skill-giang6283623-minimal-vibe-coding-kit-clearthought`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [giang6283623](https://agentstack.voostack.com/s/giang6283623)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [giang6283623](https://github.com/giang6283623)
- **Source:** https://github.com/giang6283623/minimal-vibe-coding-kit/tree/main/.cursor/skills/clearthought

## Install

```sh
agentstack add skill-giang6283623-minimal-vibe-coding-kit-clearthought
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ClearThought

Use ClearThought to turn complex or ambiguous coding work into an evidence-based implementation plan.

## Best Use

Use this skill when:

- requirements are broad, conflicting, or under-specified;
- a bug needs root-cause analysis before editing;
- an architecture or refactor decision has tradeoffs;
- a task needs to be split into small pull-request sized steps;
- the user asks for deliberate reasoning, ClearThought, or a structured decision.

## Operations

Choose the narrowest operation that fits:

- `sequential_thinking`: decompose a complex request into ordered work.
- `debugging_approach`: isolate a broken behavior with hypotheses and checks.
- `decision_framework`: compare implementation options and choose one.
- `systems_thinking`: map components, contracts, and side effects.
- `scientific_method`: define hypothesis, metric, baseline, experiment, and result.
- `risk_review`: identify safety, security, data, and rollback risks.
- `implementation_plan`: produce an edit plan, validation plan, and review checklist.

If the operation is omitted, infer it from the request. Default to `sequential_thinking`.

## Workflow

1. Read `AGENTS.md` and `backbone.yml` before repo edits.
2. Separate observed facts, assumptions, unknowns, and decisions.
3. Pick one operation and keep the reasoning focused on the next useful action.
4. Split the work into safe tasks with file or module ownership where possible.
5. Define validation commands and risk checks before editing.
6. Revisit the plan when new evidence invalidates an assumption.

## Output

For normal coding work, return this concise structure:

```markdown
## ClearThought Brief

Operation: 
Problem: 
Observed facts:
- 
Assumptions:
- 
Plan:
1. 
2. 
Validation:
- 
Risks:
- 
```

For user-invoked JSON mode, return valid JSON:

```json
{
  "toolOperation": "operation_name",
  "problem": "brief problem statement",
  "observedFacts": [],
  "assumptions": [],
  "plan": [],
  "validation": [],
  "risks": [],
  "sessionContext": {
    "sessionId": "conversation"
  }
}
```

## References And Examples

Load these only when the active task needs more detail:

- `references/parameter-reference.md`: operation parameters and accepted values.
- `references/output-schemas.md`: JSON response shapes for supported operations.
- `examples/sequential-thinking.md`: decomposition and step-by-step planning examples.
- `examples/decision-framework.md`: option comparison and tradeoff examples.
- `examples/metagame-examples.md`: OODA, Ulysses, and high-stakes reasoning examples.

## Safety

- Do not expose long hidden reasoning. Provide concise rationale and actionable conclusions.
- Do not invent facts. Mark weak evidence as an assumption or unknown.
- Do not run package lifecycle scripts, hooks, deploys, migrations, or destructive commands just to think.
- Prefer reversible changes and small diffs when uncertainty is high.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [giang6283623](https://github.com/giang6283623)
- **Source:** [giang6283623/minimal-vibe-coding-kit](https://github.com/giang6283623/minimal-vibe-coding-kit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-giang6283623-minimal-vibe-coding-kit-clearthought
- Seller: https://agentstack.voostack.com/s/giang6283623
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.