Skip to content
Back to search

claude-bedrock

MarketplaceWorks with Claude CodeGitHub

Second Brain automation for Obsidian vaults — entity management, ingestion, compression, and sync via Claude Code skills

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/iurykrieger-claude-bedrock/badge.svg)](/listings/iurykrieger-claude-bedrock)

HTML

<a href="/listings/iurykrieger-claude-bedrock"><img src="/api/listings/iurykrieger-claude-bedrock/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

/plugin marketplace add iurykrieger/claude-bedrock
/plugin install bedrock@claude-bedrock

For local development:

claude --plugin-dir ./claude-bedrock

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 35 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "claude-bedrock",
  3. "owner": {
  4. "name": "Iury Krieger"
  5. },
  6. "metadata": {
  7. "description": "Second Brain automation for Obsidian vaults — entity management, ingestion, compression, and sync via Claude Code skills"
  8. },
  9. "plugins": [
  10. {
  11. "name": "bedrock",
  12. "source": "./",
  13. "description": "Second Brain automation for Obsidian vaults — entity management, ingestion, compression, and sync via Claude Code skills",
  14. "version": "1.2.0",
  15. "author": {
  16. "name": "Iury Krieger",
  17. "url": "https://github.com/iurykrieger"
  18. },
  19. "homepage": "https://claude-bedrock.vercel.app",
  20. "repository": "https://github.com/iurykrieger/claude-bedrock",
  21. "license": "MIT",
  22. "keywords": [
  23. "obsidian",
  24. "second-brain",
  25. "knowledge-base",
  26. "zettelkasten",
  27. "vault",
  28. "knowledge-management",
  29. "knowledge-graph",
  30. "note-taking"
  31. ],
  32. "category": "knowledge-management"
  33. }
  34. ]
  35. }
README.md · README · 194 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="docs/banner.png" alt="Bedrock — Knowledge graph visualization" width="600">
  3. </p>
  4. <h1 align="center">Bedrock</h1>
  5. <p align="center">
  6. <strong>Turn any Obsidian vault into a structured Second Brain with AI agents</strong>
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/iurykrieger/claude-bedrock/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
  10. <a href="https://github.com/iurykrieger/claude-bedrock"><img src="https://img.shields.io/badge/claude--code-plugin-a882ff" alt="Claude Code Plugin"></a>
  11. <a href="https://github.com/iurykrieger/claude-bedrock"><img src="https://img.shields.io/github/v/tag/iurykrieger/claude-bedrock?label=version" alt="Version"></a>
  12. </p>
  13. ---
  14. Bedrock is a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) plugin that automates Obsidian vault management through AI-powered skills. It organizes knowledge into **7 entity types** following adapted [Zettelkasten](https://zettelkasten.de/overview/) principles — entity detection, bidirectional linking, ingestion from external sources, deduplication, and sync.
  15. No build system. No runtime. Just markdown files, AI agents, and your Obsidian vault.
  16. ## Features
  17. - **8 AI-powered skills** — setup, ask, teach, preserve, compress, sync, healthcheck, and vaults
  18. - **7 entity types** — actors, people, teams, topics, discussions, projects, and fleeting notes
  19. - **External source ingestion** — Confluence, Google Docs, GitHub repositories, and any file format supported by [docling](https://github.com/docling-project/docling) (DOCX, PPTX, XLSX, PDF, HTML, EPUB, images, and more)
  20. - **Bidirectional wikilinks** — automatic cross-referencing with Obsidian graph view
  21. - **Hierarchical tags** — multi-dimensional filtering (`type/`, `status/`, `domain/`, `scope/`)
  22. - **Zettelkasten structure** — permanent, bridge, index, and fleeting note roles
  23. - **Trunk-based git workflow** — structured commit conventions built in
  24. ## Installation
  25. ```bash
  26. /plugin marketplace add iurykrieger/claude-bedrock
  27. /plugin install bedrock@claude-bedrock
  28. ```
  29. For local development:
  30. ```bash
  31. claude --plugin-dir ./claude-bedrock
  32. ```
  33. ## Quick Start
  34. After installing, run the setup wizard:
  35. ```
  36. /bedrock:setup
  37. ```
  38. This will guide you through:
  39. 1. **Language selection** — choose the vault content language (default: English)
  40. 2. **Dependency check** — verify `graphify` is installed (required)
  41. 3. **Vault objective** — pick a preset (engineering team, product management, company wiki, personal second brain, open source project, or custom)
  42. 4. **Scaffold** — create directories, templates, config, and connected example entities
  43. The setup creates all entity directories, copies templates, generates a vault-level `CLAUDE.md`, and scaffolds example entities with bidirectional wikilinks so you can see the graph in Obsidian immediately.
  44. ## Skills
  45. | Skill | Purpose |
  46. |---|---|
  47. | `/bedrock:setup` | Interactive vault initialization and configuration |
  48. | `/bedrock:ask` | Orchestrated vault reader — decomposes questions, searches graph and vault, cross-references entities |
  49. | `/bedrock:learn` | Ingest external sources — extract and create entities |
  50. | `/bedrock:preserve` | Single write point — detect, match, create/update entities with bidirectional links |
  51. | `/bedrock:compress` | Deduplication and vault health — broken links, orphans, stale content |
  52. | `/bedrock:sync` | Re-sync entities with external sources |
  53. | `/bedrock:healthcheck` | Read-only vault health diagnostic — graphify-out integrity, orphans, dangling content, stale entries |
  54. | `/bedrock:vaults` | Manage registered vaults — list, set default, remove |
  55. ## Vault Structure
  56. ```
  57. your-vault/
  58. ├── actors/ # Systems, services, APIs (permanent notes)
  59. ├── people/ # Contributors, team members (permanent notes)
  60. ├── teams/ # Squads, organizational units (permanent notes)
  61. ├── topics/ # Cross-cutting subjects with lifecycle (bridge notes)
  62. ├── discussions/ # Meeting notes, conversations (bridge notes)
  63. ├── projects/ # Initiatives with scope and deadline (index notes)
  64. └── fleeting/ # Raw ideas, unstructured captures (fleeting notes)
  65. ```
  66. Each directory contains a `_template.md` defining the frontmatter schema for that entity type.
  67. ## How It Works
  68. Bedrock turns your vault into a living knowledge graph by combining **8 skills** you invoke from Claude Code. You never write entities by hand — skills detect, create, and link them for you, with Obsidian rendering the result as a graph.
  69. ### First-time use
  70. 1. Open a folder you want to turn into a vault (or an existing Obsidian vault).
  71. 2. Run `/bedrock:setup` — answers a few questions and scaffolds directories, templates, and example entities.
  72. 3. Open the folder in Obsidian. You'll already see a connected graph.
  73. ### Day-to-day loops
  74. - **Capture knowledge from a source** — paste a Confluence page, Google Doc, GitHub repo, remote URL, or any local file (DOCX, PPTX, XLSX, PDF, HTML, EPUB, images, and any other docling-supported format) into `/bedrock:learn`. Bedrock extracts entities and writes them to the vault with bidirectional links.
  75. - **Ask the vault questions** — use `/bedrock:ask` for anything like *"who owns the billing API?"* or *"what's the status of project X?"*. It searches the graph, follows wikilinks, and answers with citations.
  76. - **Keep sources fresh** — run `/bedrock:sync` to re-pull external sources, or `/bedrock:sync --github` / `--people` to surface recent activity and contributors.
  77. - **Clean up drift** — run `/bedrock:compress` to fix broken backlinks, merge duplicates, and consolidate fragmented concepts. Run `/bedrock:healthcheck` for a read-only report.
  78. - **Manage multiple vaults** — register several vaults with `/bedrock:vaults`; target a specific one with `--vault <name>`.
  79. ### What you get in Obsidian
  80. Every entity has YAML frontmatter (type, status, domain, sources), hierarchical tags (`type/actor`, `status/active`, `domain/payments`), and bidirectional wikilinks. The graph view becomes a navigable map of people, systems, teams, topics, and projects — updated automatically as you teach Bedrock new content.
  81. ## Dependencies
  82. | Tool | Purpose | Required? |
  83. |---|---|---|
  84. | [graphify](https://github.com/iurykrieger/graphify) | Semantic code extraction and knowledge-graph pipeline used by `/bedrock:learn` and `/bedrock:sync` | Yes |
  85. | [docling](https://github.com/docling-project/docling) | Universal file → markdown converter used by `/bedrock:learn` to ingest DOCX, PPTX, XLSX, PDF, HTML, EPUB, images, and other non-markdown formats | Yes |
  86. Both `graphify` and `docling` are auto-installed by `/bedrock:setup` (and lazily by `/bedrock:learn` on first use if missing). You can also install them manually via `pipx install graphify` / `pipx install docling`.
  87. Confluence and Google Docs ingestion are built into the plugin as internal skills (`/bedrock:confluence-to-markdown`, `/bedrock:gdoc-to-markdown`) invoked by `/bedrock:learn` and `/bedrock:sync` — no external installation required.
  88. ## Configuration
  89. Configuration is stored in `.bedrock/config.json` inside your vault. Run `/bedrock:setup` again at any time to reconfigure.
  90. ## Error Reporting
  91. The `bedrock` plugin auto-reports framework errors as GitHub issues on
  92. [iurykrieger/claude-bedrock](https://github.com/iurykrieger/claude-bedrock) so
  93. maintainers learn about real-world failures.
  94. **What gets reported**
  95. - Python tracebacks from skill scripts
  96. - Non-zero exit codes from skill bash commands
  97. - Known logical-failure phrases in Claude's text (small auditable regex catalog)
  98. **What never gets reported**
  99. - Vault content (markdown bodies, frontmatter values)
  100. - Absolute filesystem paths (replaced with `.../`)
  101. - Vault entity names (people, teams, projects, etc.)
  102. - URLs from your vault (Confluence, Google Docs, internal repos)
  103. **How to opt out**
  104. Add `"error_reporting": false` to your vault's `.bedrock/config.json`:
  105. ```json
  106. {
  107. "error_reporting": false
  108. }
  109. ```
  110. Default is `true`. The hook silently skips reporting if `gh` is not installed
  111. or you're not authenticated, and logs the would-be report to
  112. `~/.claude-bedrock-cache/error-reporter.log`.
  113. ## Contributing
  114. Contributions are welcome! Here's how to get started:
  115. 1. **Fork** the repository
  116. 2. **Clone** your fork and install the plugin locally:
  117. ```bash
  118. claude --plugin-dir ./claude-bedrock
  119. ```
  120. 3. **Create a branch** for your feature or fix
  121. 4. **Make your changes** — skills live in `skills/`, entity definitions in `entities/`, templates in `templates/`
  122. 5. **Test** by running the plugin against a test vault
  123. 6. **Open a PR** against `main`
  124. ### Project Structure
  125. ```
  126. claude-bedrock/
  127. ├── .claude-plugin/ # Plugin manifest (plugin.json)
  128. ├── skills/ # Skill definitions (SKILL.md per skill)
  129. │ ├── setup/
  130. │ ├── query/
  131. │ ├── teach/
  132. │ ├── preserve/
  133. │ ├── compress/
  134. │ └── sync/
  135. ├── entities/ # Entity type definitions
  136. ├── templates/ # Frontmatter schema templates
  137. ├── docs/ # Documentation assets
  138. ├── CLAUDE.md # AI agent instructions
  139. └── README.md
  140. ```
  141. ## License
  142. [MIT](LICENSE) — Iury Krieger

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.