# Clarify

> Articulate and clarify rough thoughts in Obsidian notes. Rewrite messy notes clearly, expand short ideas into full thoughts, or simplify tangled notes to core points. Use when the user has notes that need refining or when they know what they mean but can't say it.

- **Type:** Skill
- **Install:** `agentstack add skill-markfive-proto-obsidian-brain-vault-clarify`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [markfive-proto](https://agentstack.voostack.com/s/markfive-proto)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [markfive-proto](https://github.com/markfive-proto)
- **Source:** https://github.com/markfive-proto/obsidian-brain-vault/tree/main/skills/clarify
- **Website:** https://supermarcus.ai/brain-os

## Install

```sh
agentstack add skill-markfive-proto-obsidian-brain-vault-clarify
```

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

## About

# Clarify Pack — "I know what I mean but can't say it"

Tools for taking rough, messy, or incomplete notes and making them clear without losing the original meaning.

## Commands

### /articulate — Rewrite a messy note clearly

When the user invokes `/articulate `:

1. Read the note: `obs files read ""`
2. Read its frontmatter: `obs properties read "" --json`
3. Analyze the content:
   - Identify the core argument or idea
   - Find the logical structure hiding in the mess
   - Note any important details or nuances
4. Rewrite the body clearly:
   - Preserve the original meaning and voice
   - Add structure (headings, paragraphs, lists) where it helps
   - Convert vague references to specific `[[wikilinks]]` where notes exist
   - Keep the same frontmatter (don't change tags or properties)
5. Show the user a before/after comparison
6. Ask for confirmation before saving
7. Save with `obs files write "" --content ""`

**Important:** Never change the user's meaning. If something is ambiguous, keep it ambiguous or ask. The goal is clarity of expression, not changing what they think.

### /expand — Develop a short note into a full thought

When the user invokes `/expand `:

1. Read the note: `obs files read ""`
2. Search for related context in the vault:
   - `obs links backlinks "" --json` — what points to this note?
   - `obs search content "" --json` — where else is this discussed?
   - `obs links list "" --json` — what does this note point to?
3. Using the note content + vault context, expand it:
   - Develop the core idea with supporting points
   - Add relevant context from linked/related notes (cite them as wikilinks)
   - Include questions or open threads worth exploring
   - Add a "Related" section with discovered connections
4. Preserve existing frontmatter, add `expanded: true` property
5. Show the expansion and ask for confirmation before saving

### /simplify — Reduce a tangled note to its core points

When the user invokes `/simplify `:

1. Read the note: `obs files read ""`
2. Analyze and extract:
   - The 3 most important points (maximum)
   - The single core takeaway
   - Any action items buried in the text
3. Present as:
   ```
   ## Core Takeaway
   [One sentence]

   ## Key Points
   1. [Point one]
   2. [Point two]
   3. [Point three]

   ## Action Items
   - [ ] [Any tasks found]
   ```
4. Ask the user: "Replace the note, or save as a new summary note?"
5. If replace: `obs files write "" --content "..."`
6. If new: `obs files create "-summary.md" --content "..."`

## Tips

- Always read the note before modifying it. Never guess at content.
- Preserve wikilinks — they represent the user's intentional connections.
- When expanding, pull real context from the vault, don't fabricate connections.
- For simplify, be ruthless. Three points max. If the user wants more detail, they have the original.

## Source & license

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

- **Author:** [markfive-proto](https://github.com/markfive-proto)
- **Source:** [markfive-proto/obsidian-brain-vault](https://github.com/markfive-proto/obsidian-brain-vault)
- **License:** MIT
- **Homepage:** https://supermarcus.ai/brain-os

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-markfive-proto-obsidian-brain-vault-clarify
- Seller: https://agentstack.voostack.com/s/markfive-proto
- 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%.