How do I install the Obsidian Forge skill?

Run npx skillmds@latest add melgarafael/obsidian-forge in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Obsidian Forge safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Obsidian Forge?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Obsidian Forge free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Obsidian Forge?

melgarafael (@melgarafael) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Obsidian Forge by melgarafael — Agent Skill

Name: Obsidian Forge
Author: melgarafael

Obsidian Forge

Use quando o usuario diz "meu plano de negocio", "matematica do resultado", "abre o painel do negocio", "scanear projetos", "registrar progresso", ou invoca `/obsidian-master-kit:forge-scan|plan|dash`. Conduz entrevista dos 4 passos (3 Ps, precificacao, matematica, 7 acoes macro) conforme metodologia da aula "IA como ferramenta"; mapeia projetos ativos do PC como notas atomicas; sobe dashboard HTML estatico em localhost:4712 com File System Access API para cliques executores. 100% local, zero cloud, zero daemon.

melgarafael a26b4ff 23 files · 61.0 KB Updated Sep 17, 2026

File contents

obsidian-forge

Skill de execucao de negocio. Transforma o vault num sistema operacional pessoal pra empreender usando IA como ferramenta.

Quando usar

Usuario digita /obsidian-master-kit:forge-plan, forge-scan ou forge-dash.
Usuario fala "plano de negocio", "matematica do resultado", "abre painel".
Usuario quer registrar progresso nas metas.

Quando nao usar

Vault sem obsidian-init rodado (requer estrutura base).

Fluxo canonico

Passo 1: Detecte o vault

Walk ancestrais procurando .obsidian-master/marker.json. Senao, pede --vault PATH.

Passo 2: Escolha o sub-comando

Intencao	Sub-comando
"Varrer projetos no PC"	`scan`
"Fazer plano de negocio"	`plan`
"Abrir painel"	`dash`

Passo 3: Invoque

python3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-forge/scripts/forge.py \
  <sub-comando> [--vault PATH] [flags]

Invariantes duros

Territorialidade: so escreve em 04 - Negocio/. Nunca em outras areas.
Zero aritmetica no LLM: contas em Python/JS, validadas por teste.
Zero daemon: so CLI on-demand + hook SessionStart opt-in.
Localhost-only: http.server em 127.0.0.1.
Zero LLM no dashboard runtime: "proximo passo" e deterministico.
pt-BR hardcoded em templates, entrevista, dashboard.
Metodologia hardcoded (4 passos + 7 acoes da aula).
Dashboard requer Chromium pra edicao. Outros browsers: read-only.
Dashboard usa DOM APIs seguras: sem .innerHTML com conteudo de arquivo; tudo via createElement + textContent + replaceChildren.

Fluxo da entrevista `forge-plan` (Claude Code conduz no chat)

Passo 1+2 — 3 Ps + Precificacao

Ler _contexto.md (se existir) pra personalizar.
Perguntar: Produto (1 frase), Problema, Pessoa.
Perguntar prosa estendida de cada um.
Perguntar valor unitario + 4 bases de precificacao.
Montar JSON e chamar:

python3 forge.py plan-save-plano --respostas /tmp/respostas-plano.json

Passo 3 — Matematica

Perguntar: objetivo (titulo, valor_alvo, prazo), taxas de conversao, fonte de alcance.
Chamar math_funil.derivar_funil via script para obter funil calculado.
Mostrar funil ao user; se aprovado → chamar:

python3 forge.py plan-save-metas --respostas /tmp/respostas-metas.json

Se validar_funil retornar erro, Claude re-pergunta o que nao bate.

Passo 4 — Acoes Macro

python3 forge.py plan-save-acoes

Cria os 7 arquivos. Claude pode depois ler cada um e sugerir personalizacoes.

Estado parcial

04 - Negocio/.forge-state.json guarda passo_atual e respostas. Ao re-executar, Claude le esse arquivo pra saber onde parou e retomar.

---name: obsidian-forgedescription: Use quando o usuario diz "meu plano de negocio", "matematica do resultado", "abre o painel do negocio", "scanear projetos", "registrar progresso", ou invoca `/obsidian-master-kit:forge-scan|plan|dash`. Conduz entrevista dos 4 passos (3 Ps, precificacao, matematica, 7 acoes macro) conforme metodologia da aula "IA como ferramenta"; mapeia projetos ativos do PC como notas atomicas; sobe dashboard HTML estatico em localhost:4712 com File System Access API para cliques executores. 100% local, zero cloud, zero daemon.---# obsidian-forgeSkill de execucao de negocio. Transforma o vault num sistema operacionalpessoal pra empreender usando IA como ferramenta.## Quando usar- Usuario digita `/obsidian-master-kit:forge-plan`, `forge-scan` ou `forge-dash`.- Usuario fala "plano de negocio", "matematica do resultado", "abre painel".- Usuario quer registrar progresso nas metas.## Quando **nao** usar- Vault sem `obsidian-init` rodado (requer estrutura base).## Fluxo canonico### Passo 1: Detecte o vaultWalk ancestrais procurando `.obsidian-master/marker.json`. Senao,pede `--vault PATH`.### Passo 2: Escolha o sub-comando| Intencao | Sub-comando ||---|---|| "Varrer projetos no PC" | `scan` || "Fazer plano de negocio" | `plan` || "Abrir painel" | `dash` |### Passo 3: Invoque```bashpython3 ${CLAUDE_PLUGIN_ROOT}/skills/obsidian-forge/scripts/forge.py \ <sub-comando> [--vault PATH] [flags]```## Invariantes duros1. **Territorialidade**: so escreve em `04 - Negocio/`. Nunca em outras areas.2. **Zero aritmetica no LLM**: contas em Python/JS, validadas por teste.3. **Zero daemon**: so CLI on-demand + hook `SessionStart` opt-in.4. **Localhost-only**: `http.server` em `127.0.0.1`.5. **Zero LLM no dashboard runtime**: "proximo passo" e deterministico.6. **pt-BR hardcoded** em templates, entrevista, dashboard.7. **Metodologia hardcoded** (4 passos + 7 acoes da aula).8. **Dashboard requer Chromium** pra edicao. Outros browsers: read-only.9. **Dashboard usa DOM APIs seguras**: sem `.innerHTML` com conteudo de arquivo; tudo via `createElement` + `textContent` + `replaceChildren`.## Fluxo da entrevista `forge-plan` (Claude Code conduz no chat)### Passo 1+2 — 3 Ps + Precificacao1. Ler `_contexto.md` (se existir) pra personalizar.2. Perguntar: Produto (1 frase), Problema, Pessoa.3. Perguntar prosa estendida de cada um.4. Perguntar valor unitario + 4 bases de precificacao.5. Montar JSON e chamar:```bashpython3 forge.py plan-save-plano --respostas /tmp/respostas-plano.json```### Passo 3 — Matematica1. Perguntar: objetivo (titulo, valor_alvo, prazo), taxas de conversao, fonte de alcance.2. Chamar `math_funil.derivar_funil` via script para obter funil calculado.3. Mostrar funil ao user; se aprovado → chamar:```bashpython3 forge.py plan-save-metas --respostas /tmp/respostas-metas.json```Se `validar_funil` retornar erro, Claude re-pergunta o que nao bate.### Passo 4 — Acoes Macro```bashpython3 forge.py plan-save-acoes```Cria os 7 arquivos. Claude pode depois ler cada um e sugerir personalizacoes.### Estado parcial`04 - Negocio/.forge-state.json` guarda `passo_atual` e respostas. Aore-executar, Claude le esse arquivo pra saber onde parou e retomar.

Frequently asked questions