# Wiki > Inicializa, adopta y enruta el trabajo hacia un vault de Obsidian separado a través del core portátil `claude-obsidian`. Para configurar el vault o elegir el sub-skill correcto. Fuente: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki Markdown: https://skillsagentes.com/skills/agricidaniel/claude-obsidian/wiki.md Repositorio: https://github.com/AgriciDaniel/claude-obsidian Autor: AgriciDaniel Licencia: MIT Actualizado: hace 3 días Coste de contexto: 95 tok instalada, 1.3k tok al activarse, 8.7k tok con todos los archivos del bundle Bundle: 11 archivos, 34 KB Permisos que pide: ninguno declarado ## Instalación Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina. ```bash # Claude Code npx -y skills add AgriciDaniel/claude-obsidian --skill wiki --agent claude-code # Cursor npx -y skills add AgriciDaniel/claude-obsidian --skill wiki --agent cursor # Codex npx -y skills add AgriciDaniel/claude-obsidian --skill wiki --agent codex # Gemini CLI npx -y skills add AgriciDaniel/claude-obsidian --skill wiki --agent gemini # Windsurf npx -y skills add AgriciDaniel/claude-obsidian --skill wiki --agent windsurf # Cline npx -y skills add AgriciDaniel/claude-obsidian --skill wiki --agent cline ``` ## Qué hace - Inicializa o adopta un vault de Obsidian separado a través del core portátil `claude-obsidian` - Resuelve el vault por `--vault`, `CLAUDE_OBSIDIAN_VAULT`, `.claude-obsidian.json` o detección en el directorio actual - Enruta la intención del usuario hacia el sub-skill correcto: `wiki-ingest`, `wiki-query`, `save`, `autoresearch`, `wiki-lint`, `wiki-fold` o `canvas` - Empaqueta cualquier configuración o scaffold personalizado en una única transacción `claude-obsidian.transaction.v1` revisable ## Cuándo usarla - Se necesita configurar un vault, adoptar uno existente, seleccionar un workspace o elegir el sub-skill correcto de wiki - Se pide crear una base de conocimiento persistente o un segundo cerebro ## Qué la activa - "Configura mi vault de Obsidian" - "Adopta este vault existente" - "Crea una base de conocimiento persistente" - "¿Qué skill debo usar para ingestar esta fuente?" ## Antes de instalar - Necesita el core `claude-obsidian.py` instalado y `python3` disponible. - Necesita en el PATH: python3 - Variables de entorno: CORE - reads environment config ## Archivos - SKILL.md — 5 KB - references/css-snippets.md — 4 KB - references/frontmatter.md — 2 KB - references/git-setup.md — 3 KB - references/install-modes.md — 2 KB - references/mcp-setup.md — 2 KB - references/modes.md — 3 KB - references/operation-transactions.md — 6 KB - references/plugins.md — 2 KB - references/provenance.md — 3 KB - references/rest-api.md — 1 KB ## SKILL.md Reproducido tal cual desde AgriciDaniel/claude-obsidian bajo MIT. Esta sección es el documento original y está en inglés. # Wiki orchestration Treat the installed product as code and the selected user vault as data. Never use the plugin/product root as a vault, even when the current directory happens to be the product checkout. Resolve the portable core from this skill's installation and invoke it by absolute path: ```bash CORE=/absolute/product/root/scripts/claude-obsidian.py python3 "$CORE" --help ``` Resolve a vault in this order: explicit `--vault`, `CLAUDE_OBSIDIAN_VAULT`, the nearest `.claude-obsidian.json`, then an unambiguous initialized vault at or above the current directory. Fail closed when selection is missing or ambiguous. Baseline setup requires no network egress. Do not fetch templates, plugins, or remote content unless the user separately approves the destinations and budget. ## Set up a vault Use the deterministic setup commands. Both are dry-run by default. For a new, separate vault: ```bash python3 "$CORE" init /absolute/path/to/vault \ --generated-at --operation-id init-reviewed python3 "$CORE" init /absolute/path/to/vault \ --generated-at --operation-id init-reviewed \ --approved-plan-sha256 --apply ``` For an existing Obsidian vault: ```bash python3 "$CORE" adopt /absolute/path/to/vault \ --generated-at --operation-id adopt-reviewed python3 "$CORE" adopt /absolute/path/to/vault \ --generated-at --operation-id adopt-reviewed \ --approved-plan-sha256 --apply ``` Before `--apply`, show the selected path and changed-path preview, then pass the emitted `approved_plan_sha256` unchanged. Do not use `--force` unless the user has reviewed the conflicts and explicitly approved replacement. Setup is non-destructive by default and creates no upstream Git remote. If the user asks for a domain-specific scaffold, establish the baseline first, then read [modes.md](references/modes.md). Draft the additional pages and configuration as one operation-level transaction. Never mutate vault files with host Write/Edit tools or an Obsidian transport. ## Route operations Route the user's intent without silently broadening it: | Intent | Skill | |---|---| | Ingest supplied sources | `wiki-ingest` | | Answer from existing vault knowledge | `wiki-query` | | Save a specific conversation result | `save` | | Research the public web under a budget | `autoresearch` | | Check vault health | `wiki-lint` | | Roll up log entries | `wiki-fold` | | Work with a canvas | `canvas` | Query is read-only. Persistence from a query must be an explicit, separately scoped Save operation. Never capture a transcript or update the hot cache merely because a session ended. ## Mutation contract Read [operation-transactions.md](references/operation-transactions.md) before any custom scaffold or mutation. One logical operation must produce one inspected and recoverable `claude-obsidian.transaction.v1` bundle. Parallel agents may return drafts and evidence only; the orchestrator merges them and applies once. Every canonical page create or removal includes an active index or MOC update in that bundle; update the overview only when the stable high-level picture changed. Raw source payloads are create-only. There are no automatic commits. Use [provenance.md](references/provenance.md) when initializing or changing source and claim ledgers. Unsupported evidence stays unsupported; never invent a source, quote, date, locator, or confidence. After a successful apply, report the operation ID and exact changed paths. If the user explicitly wants a Git checkpoint, run it separately: ```bash python3 "$CORE" checkpoint OPERATION_ID --vault /absolute/path/to/vault ``` On a conflict, re-read and rebuild. On interruption, use `transaction recover`. Reuse an operation ID only with the identical bundle. ## Installation context Read [install-modes.md](references/install-modes.md) when installation or host behavior matters. Hooks are optional adapters; portable behavior lives in the core and skills. ## Conditional references Read only the reference needed for the current request: - [frontmatter.md](references/frontmatter.md) when defining or adopting a property schema; - [css-snippets.md](references/css-snippets.md) for requested Obsidian visual customization; - [git-setup.md](references/git-setup.md) for explicit local Git or checkpoint setup; - [plugins.md](references/plugins.md) when evaluating optional Obsidian integrations; - [mcp-setup.md](references/mcp-setup.md) when the user asks to evaluate an external read transport; - [rest-api.md](references/rest-api.md) only when the user explicitly has or requests the Local REST API adapter. ## Think, verify, grow Before applying, pause once: observe existing state, verify the vault selection and evidence, then choose the smallest reversible operation that satisfies the request. Afterward, report uncertainty and the next useful improvement without performing it automatically. ## Dónde encaja - Categoría: [Productividad](https://skillsagentes.com/categorias/productividad.md) — Planificación, toma de notas y automatización de flujos personales. - Creador: [AgriciDaniel](https://skillsagentes.com/creators/agricidaniel.md) — 46 skills en el directorio - [Todas las skills](https://skillsagentes.com/skills.md) - [Ranking de instalaciones](https://skillsagentes.com/ranking.md) ## Otras skills del mismo repositorio - [Canvas](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/canvas.md): Crea, inspecciona y actualiza tableros Obsidian JSON Canvas con nodos de texto, archivo, enlace, grupo y arista. Para estado del canvas, mapas visuales, zonas y diseños espaciales. - [Defuddle](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/defuddle.md): Planifica y, con consentimiento explícito de red, usa un limpiador externo Defuddle opcional para extraer páginas HTTPS tipo artículo como Markdown. - [Obsidian Bases](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-bases.md): Explica, redacta y valida archivos Obsidian Bases `.base` con filtros, fórmulas, propiedades, resúmenes y vistas de tabla, tarjetas o lista. - [Obsidian Markdown](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/obsidian-markdown.md): Explica, redacta o valida la sintaxis de Obsidian Flavored Markdown: propiedades, wikilinks, embeds, callouts, tags, comentarios, resaltados, referencias de bloque, matemáticas y Mermaid. - [Autoresearch](https://skillsagentes.com/skills/agricidaniel/claude-obsidian/autoresearch.md): Ejecuta un bucle de investigación acotado y basado en fuentes, redacta un dossier citado y opcionalmente propone una fusión revisada aparte en el vault canónico. --- Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)