# Obsidian Markdown

> Required companion skill for writing Obsidian-native Markdown notes with YAML properties, wikilinks, callouts, embeds, block IDs, tags, aliases, MOCs, and graph-friendly note structure. Use whenever creating or editing notes in an Obsidian vault.

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

## Install

```sh
agentstack add skill-lionellau-capture-concept-obsidian-markdown
```

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

## About

# Obsidian Markdown

Use this skill whenever writing or editing notes inside an Obsidian vault.

## Core Rules

- Use YAML frontmatter for note properties.
- Use Obsidian wikilinks for internal links: `[[note-slug]]` or `[[note-slug|Title]]`.
- Use heading links for precise references: `[[note-slug#Heading]]`.
- Use block IDs for reusable definitions or claims: `^definition`, `^key-claim`.
- Use Obsidian callouts for scannable structure.
- Use embeds only when the target exists: `![[note-slug#^definition]]`.
- Keep sections chunkable; split sections that exceed about 300 words.

## Frontmatter Pattern

```markdown
---
title: "Human Title"
type: concept
domain: software-engineering
depth: working
scenario: S1
tags:
  - domain/software-engineering
  - status/active
  - topic/caching
  - source/conversation
related:
  - "cache-invalidation"
created: "2026-06-11"
updated: "2026-06-11"
confidence: medium
provenance: inferred
aliases:
  - "alternate name"
stub_candidates:
  - "missing-related-concept"
---
```

## Callouts

Prefer these callouts:

- `> [!tldr]` for retrieval hooks.
- `> [!note]` for disambiguation.
- `> [!tip]` for decision criteria or rules of thumb.
- `> [!warning]` for pitfalls.
- `> [!failure]-` for anti-patterns or dead ends.
- `> [!bug]-` for known limitations or failure modes.
- `> [!quote]` for attributed source claims.
- `> [!question]-` for open questions and stubs.

Use foldable callouts with `-` when details are useful but not essential.

## Tags

- Use slash tags: `domain/software-engineering`, `topic/debugging`, `source/article`.
- Do not use broad generic topic tags.
- Keep topic tags specific and limited.
- Prefer mechanism tags over surface-area tags.

## Links

Only place verified existing notes in `related:`. Missing concepts belong in
`stub_candidates:` until a note exists.

In the body, every related link should explain the relationship:

```markdown
- [[cache-invalidation]] - broader failure class behind this bug.
```

## MOCs And Indexes

MOCs should help navigation, not duplicate tags. Include:

- Recent notes
- Learning paths
- Important gaps
- Links grouped by practical use

## Source & license

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

- **Author:** [lionellau](https://github.com/lionellau)
- **Source:** [lionellau/capture-concept](https://github.com/lionellau/capture-concept)
- **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-lionellau-capture-concept-obsidian-markdown
- Seller: https://agentstack.voostack.com/s/lionellau
- 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%.