Skip to main content
skillsSource-backed

Plasma Wiki

Keep project knowledge in plain Markdown while a deterministic CLI maintains folder indexes, cross-links, structure checks, and scoped map, search, and read commands for agents.

by Plasma AI · submitted by ryanpettry·added 2026-07-24·
Level:advancedType:generalVerified:validated
Review first review before installing

Open the source and read safety notes before installing.

Citation facts

Source-backed facts for citing this resource, derived directly from the registry — also available as plain text for AI assistants.

Source URLs
https://docs.plasma.ai/wiki/, https://github.com/plasma-ai/wiki
Safety notes
`wiki init`, `wiki config`, and `wiki update` write local Markdown structure, settings, frontmatter, headings, `.gitattributes`, and clone-local Git merge-driver configuration. Review the diff before committing it., `wiki trust` authorizes the selected wiki's `.wiki/wiki.py` hook to execute with the user's privileges. Read that file before trusting a cloned or third-party wiki., `wiki init` and `wiki config` can download the pinned Front Matter Title Obsidian plugin from GitHub. Obsidian itself remains optional., The `***` delimiter and `[[wikilinks]]` are load-bearing syntax. Use `mdformat-wiki` or exclude the wiki root from formatters that rewrite them.
Privacy notes
`wiki map`, `wiki search`, and `wiki read` inspect local project documentation. Pages supplied to an active agent can become part of that agent's model context and logs., Wiki content, `.wiki/settings.json`, and generated indexes remain ordinary local files, but Git remotes, backups, and collaboration tools can copy them according to the user's repository policy., Package installation contacts the selected Python package index, while optional Obsidian setup contacts GitHub to download the pinned plugin release.
Platform compatibility
claude-code (native-skill), codex (native-skill), windsurf (native-skill), gemini (native-skill), cursor (adapter), cli (manual-context)
Author
Plasma AI
Submitted by
ryanpettry
Claim status
unclaimed
Last verified
2026-07-24

Decision playbook

Review trust signals before you adopt

Signals are present but mixed. Use the checklist below to confirm the source and operational safety for your environment.

Compare context
Selected

0

Current score

71

Baseline

Delta

No baseline selected

No major trust-signal divergence detected in the current selection.

Source and provenance checks

Needs review

Confirm ownership and provenance before trusting install instructions.

  • Source link availableRequired

    Open the canonical repository and verify ownership.

    Done
  • Source provenance statusRequired

    Marked as source-backed.

    Done
  • Metadata reviewed

    No reviewed flag detected in metadata.

    Pending

Safety and privacy checks

Complete

Validate risk disclosures before installation or API wiring.

  • Safety notes presentRequired

    Review the listed safety guidance before running commands.

    Done
  • Privacy notes presentRequired

    Review data handling notes before connecting accounts or secrets.

    Done
  • Trust level risk gateRequired

    Trust level does not block evaluation.

    Done

Package and install checks

Needs review

Check package metadata and artifact integrity signals.

  • Install payload available

    Install or copy payload is available for review.

    Done
  • Package verification flag

    No package verification flag provided.

    Pending
  • Checksum metadata

    No checksum provided for downloaded artifact.

    Pending

Compare-driven decision checks

Needs review

Use compare context to validate trade-offs before adoption.

  • Compare tray has multiple entries

    Add at least one more entry to compare trust differences.

    Pending
  • Baseline comparison available

    No baseline peer selected yet.

    Pending
  • Diverging trust signals identified

    No major trust-signal divergence found.

    Pending

Setup at a glance

Package install

Copy-ready — paste the snippet to get started.

Adoption plan

Balanced adoption plan

Current risk score 24/100. Use staged verification before broader rollout.

Risk 24

Pre-adoption checks

Validate source and review signals before any execution.

  • Confirm source provenanceRequired

    Source URL/provenance metadata is present.

    Done
  • Confirm metadata review state

    No review metadata found; increase manual validation.

    Pending
  • Verify install payload

    Install/config payload exists and can be inspected.

    Done

Security checks

Confirm safety, privacy, and package integrity signals.

  • Review safety notesRequired

    Safety notes are present.

    Done
  • Review privacy notesRequired

    Privacy notes are present.

    Done
  • Verify package integrity metadata

    No package verification/checksum metadata.

    Pending

Rollout

Adopt in controlled steps based on the selected plan.

  • Run in isolated sandbox firstRequired

    Use a constrained sandbox and observe behavior across multiple tasks.

    Pending
  • Roll out graduallyRequired

    Roll out to a small cohort before wider usage.

    Pending
  • Set monitoring and fallback

    Define rollback path and monitor errors after adoption.

    Pending

Evidence readiness

Evidence readiness matrix · balanced

Missing required evidence: Metadata review. Risk score 31.

Risk 31

Source provenance

Present

Source repository/provenance is listed.

Required in this preset

Metadata review

Missing

Review metadata is missing.

Required in this preset

Safety notes

Present

Safety notes are present.

Required in this preset

Privacy notes

Present

Privacy notes are present.

Optional in this preset

Package integrity

Missing

Package integrity metadata is missing.

Optional in this preset

Install payload

Present

Install payload is available.

Required in this preset

Required gaps: Metadata review

Decision timeline

Decision timeline · balanced

Blocking gaps: Check metadata review status. Risk 28.

Risk 28

triage

Confirm source provenanceRequired

Source/provenance metadata is available.

Done

triage

Check metadata review statusRequired

Review metadata is missing.

Pending

verify

Review safety notesRequired

Safety notes are available.

Done

verify

Review privacy notes

Privacy notes are available.

Done

verify

Validate package integrity metadata

Package integrity metadata is missing.

Pending

rollout

Verify install payload and commandsRequired

Install payload is available.

Done

Blockers: Check metadata review status

Prerequisite readiness

Prerequisite readiness

3 prerequisites to line up before setup.

0/3 ready
Install & runtime3

Safety & privacy surface

Safety & privacy surface

4 safety and 3 privacy notes across 4 risk areas. Review closely: permissions & scopes, network access.

4 areas
  • SafetyGeneral`wiki init`, `wiki config`, and `wiki update` write local Markdown structure, settings, frontmatter, headings, `.gitattributes`, and clone-local Git merge-driver configuration. Review the diff before committing it.
  • SafetyPermissions & scopes`wiki trust` authorizes the selected wiki's `.wiki/wiki.py` hook to execute with the user's privileges. Read that file before trusting a cloned or third-party wiki.
  • SafetyNetwork access`wiki init` and `wiki config` can download the pinned Front Matter Title Obsidian plugin from GitHub. Obsidian itself remains optional.
  • SafetyGeneralThe `***` delimiter and `[[wikilinks]]` are load-bearing syntax. Use `mdformat-wiki` or exclude the wiki root from formatters that rewrite them.
  • PrivacyData retention`wiki map`, `wiki search`, and `wiki read` inspect local project documentation. Pages supplied to an active agent can become part of that agent's model context and logs.
  • PrivacyNetwork accessWiki content, `.wiki/settings.json`, and generated indexes remain ordinary local files, but Git remotes, backups, and collaboration tools can copy them according to the user's repository policy.
  • PrivacyNetwork accessPackage installation contacts the selected Python package index, while optional Obsidian setup contacts GitHub to download the pinned plugin release.

Safety notes

  • `wiki init`, `wiki config`, and `wiki update` write local Markdown structure, settings, frontmatter, headings, `.gitattributes`, and clone-local Git merge-driver configuration. Review the diff before committing it.
  • `wiki trust` authorizes the selected wiki's `.wiki/wiki.py` hook to execute with the user's privileges. Read that file before trusting a cloned or third-party wiki.
  • `wiki init` and `wiki config` can download the pinned Front Matter Title Obsidian plugin from GitHub. Obsidian itself remains optional.
  • The `***` delimiter and `[[wikilinks]]` are load-bearing syntax. Use `mdformat-wiki` or exclude the wiki root from formatters that rewrite them.

Privacy notes

  • `wiki map`, `wiki search`, and `wiki read` inspect local project documentation. Pages supplied to an active agent can become part of that agent's model context and logs.
  • Wiki content, `.wiki/settings.json`, and generated indexes remain ordinary local files, but Git remotes, backups, and collaboration tools can copy them according to the user's repository policy.
  • Package installation contacts the selected Python package index, while optional Obsidian setup contacts GitHub to download the pinned plugin release.

Prerequisites

  • Python 3.11 through 3.14 and pip, pipx, or uv for the published `plasma-wiki` package.
  • A repository or folder where the user permits the CLI to create and update Markdown files, `.wiki/settings.json`, and generated indexes.
  • Claude Code, Codex, or another Agent Skills host for the bundled `/wiki` skill; the CLI also works directly from a terminal.

Schema details

Install type
package
Reading time
6 min
Difficulty score
64
Troubleshooting
Yes
Breaking changes
No
Source repository stats
Scope
Source repo
Skill and platform metadata
Skill type
general
Skill level
advanced
Verification
validated
Verified at
2026-07-24
Retrieval sources
https://github.com/plasma-ai/wikihttps://github.com/plasma-ai/wiki/blob/main/README.mdhttps://github.com/plasma-ai/wiki/blob/main/wiki/skills/wiki/SKILL.mdhttps://github.com/plasma-ai/pluginshttps://docs.plasma.ai/wiki/https://pypi.org/project/plasma-wiki/
Tested platforms
Claude CodeCodex
PlatformSupportInstall path
claude-codeNative.claude/skills/<skill-name>/SKILL.md
codexNative.agents/skills/<skill-name>/SKILL.md
windsurfNative.windsurf/skills/<skill-name>/SKILL.md
geminiNative.gemini/skills/<skill-name>/SKILL.md or .agents/skills/<skill-name>/SKILL.md
cursorAdapter.cursor/rules/<skill-name>.mdc
cliManualAGENTS.md or tool-specific context file
Tool listing metadata
Full copyable content
wiki init
wiki update
wiki lint
wiki map
wiki search "authentication"
wiki read auth

About this resource

Plasma Wiki

Plasma Wiki turns a folder of Markdown files into an indexed knowledge base for people and agents. A deterministic CLI maintains _index.md pages, cross-links, frontmatter, structure checks, and the generated region of index merges. People and agents remain responsible for the content.

The agent workflow is intentionally small: map the tree, search for the topic, then read only the pages the task needs. The knowledge base stays in plain files that users can edit and review through Git.

Knowledge freshness

This listing was verified on 2026-07-24 against the public repository, canonical SKILL.md, documentation, and the published plasma-wiki 1.1.0 package. The source is Apache-2.0 licensed.

Retrieval sources

Installation

Install the CLI in an isolated Python environment, then copy the bundled skill into the supported agent skill directories:

pipx install plasma-wiki
wiki install

The documented plugin marketplace routes are also available:

# Claude Code
/plugin marketplace add plasma-ai/plugins
/plugin install wiki@plasma

# Codex
codex plugin marketplace add plasma-ai/plugins
codex plugin add wiki@plasma

Run wiki install again after upgrading a copied skill. Editable installs can use wiki install --link.

Core workflow

Initialize a wiki and keep its generated structure current:

wiki init
wiki update
wiki lint

Agents retrieve context through three commands:

wiki map
wiki search "authentication"
wiki read auth

wiki map prints the indexed tree and word counts. wiki search performs text search using Python regular expressions. wiki read loads one named entry and can slice it by words, lines, or characters.

Capability scope

  • Creates folder-based Markdown knowledge bases with _index.md navigation.
  • Maintains generated links, frontmatter, headings, and structural lint rules.
  • Lets agents map the tree, search text, and read selected pages or subtrees.
  • Keeps authored content in ordinary files that people can edit in Obsidian or any Markdown editor.
  • Configures a Git merge driver for the generated region of _index.md files while leaving authored conflicts visible.
  • Supports project-specific naming, exclusions, timestamp, title, and map settings through .wiki/settings.json.
  • Requires explicit wiki trust before a repository hook can execute.

Compatibility

Native

  • Claude Code through the Plasma plugin marketplace or wiki install.
  • Codex through the Plasma plugin marketplace or wiki install.
  • Direct terminal workflows through the published wiki CLI.

Manual adaptation

Other Agent Skills hosts can load the canonical wiki/skills/wiki/SKILL.md file if they support the standard SKILL.md format.

Safety and privacy

Wiki maintenance commands write files. Review wiki update --check, use Git diffs, and keep authored pages under the repository's normal review policy. After cloning a repository, run wiki config to restore the clone-local merge driver before relying on generated-index merge handling.

A wiki may include .wiki/wiki.py to customize indexing or formatting. wiki refuses to load that hook until the user runs wiki trust. Inspect the hook first because trust allows it to execute with the user's privileges.

The retrieval commands operate on local Markdown, but any page handed to an agent can enter that agent's model context, transcript, or provider logs. Keep secrets, customer data, credentials, and regulated information out of the wiki unless the selected agent environment is approved for them.

Troubleshooting

Issue: A formatter changes *** to --- or escapes [[wikilinks]]
Fix: Install mdformat-wiki, remove a conflicting mdformat-frontmatter plugin, or exclude the wiki root from that formatter.

Issue: Generated _index.md sections conflict after a fresh clone
Fix: Run wiki config in that clone to register the local Git merge driver.

Issue: The installed agent skill does not reflect a package upgrade
Fix: Run wiki install again, or use wiki install --link from an editable install.

Duplicate review

HeyClaude already lists Markdown Knowledge Base Composer, which consolidates Markdown folders and exports combined documents. Plasma Wiki instead maintains an indexed source tree for selective agent navigation and retrieval. The Obsidian Agent Skills entry covers Obsidian-specific authoring and development workflows; Plasma Wiki can use Obsidian as an optional editor but owns its indexing and CLI workflow independently.

Editorial disclosure

Submitted by a contributor affiliated with Plasma AI. This is a source-backed community listing for the Apache-2.0 project.

Source citations

Add this badge to your README

Show that Plasma Wiki is listed on HeyClaude. Paste this Markdown into your README — it renders the badge and links back to this page.

Listed on HeyClaude
[![Listed on HeyClaude](https://heyclau.de/badge/skills/plasma-wiki.svg)](https://heyclau.de/entry/skills/plasma-wiki)

How it compares

Plasma Wiki side by side with 3 alternatives on trust, install, platform support, and disclosed safety notes — all from reviewed registry metadata.

1 trust signal differ across this comparison (Submitter).

Field

Keep project knowledge in plain Markdown while a deterministic CLI maintains folder indexes, cross-links, structure checks, and scoped map, search, and read commands for agents.

Open dossier

MIT-licensed BrowserAct Agent Skill pack for installing and operating the `browser-act` browser automation CLI from Claude Code, Codex, OpenClaw, Cursor, OpenCode, Windsurf, Gemini CLI, and other skills-compatible agents.

Open dossier

MIT-licensed Agent Skills collection for context engineering, harness engineering, multi-agent architectures, filesystem context, memory systems, tool design, evaluation, hosted agents, and production agent operating loops for Claude Code, Cursor, Codex, and Open Plugins-compatible agent tools.

Open dossier

Agent Skills for Obsidian by Steph Ango, teaching Claude Code, Codex, OpenCode, and skills-compatible agents to work with Obsidian Flavored Markdown, Bases, JSON Canvas, Obsidian CLI, vaults, plugins, themes, and Defuddle-powered web-to-markdown extraction.

Open dossier
Next steps
Trust
Review statusNot reviewedNot reviewedNot reviewedNot reviewed
Package trustPackage not verifiedPackage not verifiedPackage not verifiedPackage not verified
Source provenanceSource-backedSource-backedSource-backedSource-backed
SubmitterDiffersryanpettry
Install riskReview firstReview firstReview firstReview first
Notes Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓ Safety ✓ Privacy ✓
BrandCursor logoCursorCursor logoCursor
Categoryskillsskillsskillsskills
SourceSource-backedSource-backedSource-backedSource-backed
AuthorPlasma AIBrowserActMuratcan KoylanSteph Ango
Added2026-07-242026-06-182026-06-182026-06-18
Platforms
Harness
Source repo
Safety notes`wiki init`, `wiki config`, and `wiki update` write local Markdown structure, settings, frontmatter, headings, `.gitattributes`, and clone-local Git merge-driver configuration. Review the diff before committing it. `wiki trust` authorizes the selected wiki's `.wiki/wiki.py` hook to execute with the user's privileges. Read that file before trusting a cloned or third-party wiki. `wiki init` and `wiki config` can download the pinned Front Matter Title Obsidian plugin from GitHub. Obsidian itself remains optional. The `***` delimiter and `[[wikilinks]]` are load-bearing syntax. Use `mdformat-wiki` or exclude the wiki root from formatters that rewrite them.BrowserAct can open pages, click, type, upload files, inspect state, capture screenshots, read page text, handle dialogs, export cookies, capture network requests, and operate logged-in browser sessions. Use BrowserAct only on sites, accounts, and data sources where the user has authorization. Do not use it to evade access controls, violate site terms, scrape disallowed data, or bypass rate limits. The entry skill declares confirmation gates for browser creation, deletion, local Chrome profile import, proxy/security changes, logins, form submissions, file uploads, and other sensitive operations; preserve those gates in agent workflows. `solve-captcha` may send the challenge image to BrowserAct's verification-assistance service according to the skill metadata; do not use it with sensitive or unauthorized pages. `remote-assist` can generate a live handoff URL for a human to take over. Treat that URL as access to the active browser session. Skill Forge can generate reusable automation skills from explored sites. Review generated scripts, selectors, network assumptions, output schemas, and site authorization before reusing them at scale.These skills alter how agents select context, delegate work, persist state, design tools, evaluate outputs, and operate autonomous loops; use them as engineering guidance, not as automatic authority to change a production agent system. Filesystem-context and memory-system patterns can cause agents to write durable plans, scratchpads, logs, summaries, preferences, or shared handoff files. Keep cleanup, ownership, and review rules explicit. Harness-engineering, hosted-agent, and evaluation workflows can launch long-running loops, background agents, benchmark suites, paid model calls, or remote sandbox work. Require budgets, kill switches, rollback rules, and approval gates. Tool-design guidance can change MCP schemas, tool descriptions, return formats, and error contracts. Test routing and compatibility before deploying changes to users. Benchmark results are source evidence for this repository's claims, but they are workload-specific. Re-run or adapt benchmarks before relying on the reported routing numbers in a different agent stack.Obsidian vaults often contain personal notes, private research, customer context, credentials in notes, meeting records, and unpublished plans; scope agent access carefully. The Obsidian CLI skill can guide vault operations, plugin work, and theme development, so review commands before running them against a real vault. JSON Canvas and Bases edits can alter knowledge organization, saved views, formulas, and linked note structures; review generated files before syncing or publishing. Defuddle-powered extraction can bring third-party web content into a vault; check source attribution, copyright, and cleanup before sharing extracted notes.
Privacy notes`wiki map`, `wiki search`, and `wiki read` inspect local project documentation. Pages supplied to an active agent can become part of that agent's model context and logs. Wiki content, `.wiki/settings.json`, and generated indexes remain ordinary local files, but Git remotes, backups, and collaboration tools can copy them according to the user's repository policy. Package installation contacts the selected Python package index, while optional Obsidian setup contacts GitHub to download the pinned plugin release.BrowserAct workflows can expose page content, screenshots, URLs, credentials typed into forms, cookies, browser profiles, uploaded files, downloaded files, network requests, HAR data, session names, browser descriptions, and logs. The BrowserAct skill metadata states that cookies, login sessions, page content, credentials, and browser profile data stay local, except the CAPTCHA challenge image when `solve-captcha` is invoked. Chrome-direct and profile import workflows can connect agents to existing local browser state. Treat those modes as account access, not a blank test browser. Log reports, feedback, Discord support, generated Skill Forge packages, and shared screenshots can leak private browsing or account context if submitted without review. Managed proxy, stealth browser, and API-key features create additional BrowserAct service dependencies beyond local CLI execution.Context-engineering work often touches prompts, system instructions, tool definitions, retrieved documents, message history, tool outputs, logs, scratch files, memory stores, benchmark prompts, and model responses. Do not persist secrets, customer data, private source code, incident data, unpublished strategy, or regulated records into scratchpads, skill examples, benchmark fixtures, or shared agent workspaces. If benchmark runners or hosted-agent examples call external models or remote sandboxes, review what prompts, traces, files, and logs are sent outside the local workspace. Agent memory and filesystem-context patterns should include deletion, redaction, retention, and access-control rules before being used with private projects.Using the skills can expose note contents, backlinks, properties, canvases, Base queries, plugin code, theme files, vault paths, web extracts, and personal knowledge workflows to the configured model provider. Do not share private journals, client notes, regulated data, secret recovery phrases, API keys, unreleased plans, or internal knowledge bases unless the agent environment is approved for that data. When committing or publishing generated vault files, review embedded links, frontmatter properties, canvas text, extracted quotes, and metadata for private information.
Prerequisites
  • Python 3.11 through 3.14 and pip, pipx, or uv for the published `plasma-wiki` package.
  • A repository or folder where the user permits the CLI to create and update Markdown files, `.wiki/settings.json`, and generated indexes.
  • Claude Code, Codex, or another Agent Skills host for the bundled `/wiki` skill; the CLI also works directly from a terminal.
  • Python 3.12 or newer and the uv package manager for the documented CLI install path.
  • A compatible agent host that can read `SKILL.md` files and execute shell commands.
  • Chrome or Chromium for local `chrome` and `chrome-direct` browser modes.
  • A BrowserAct API key only for optional stealth browsers, stealth extraction, managed proxies, and CAPTCHA assistance.
  • Claude Code plugin support, Cursor Open Plugins support, or an agent host that can load Agent Skills or custom instruction files.
  • A project where context-window behavior, multi-agent structure, tool design, memory, evaluation, or harness reliability is a real design concern.
  • A version-controlled workspace for any scripts, examples, benchmark artifacts, or generated skill changes.
  • Human review before applying benchmark-derived skill changes, modifying persistent agent memory, changing tool schemas, or deploying autonomous harness loops.
  • An Obsidian vault or project folder where an agent is allowed to read and write Markdown, Base, Canvas, plugin, or theme files.
  • Claude Code plugin support, `npx skills`, Codex skills path access, OpenCode skills directory access, or another Agent Skills compatible host.
  • Obsidian CLI only for workflows that explicitly need vault interaction, plugin development, or theme development through the CLI.
  • A backup, git history, or review workflow before allowing an agent to edit important vault notes or canvases.
Install
pipx install plasma-wiki
wiki install
uv tool install browser-act-cli --python 3.12
/plugin marketplace add muratcankoylan/Agent-Skills-for-Context-Engineering
/plugin marketplace add kepano/obsidian-skills
Config
Citations
ClaimUnclaimedUnclaimedUnclaimedUnclaimed
Open 4 picks in the interactive comparison tool

Related guides

Signals

Loading live community signals…

More like this, weekly

A short, calm digest of reviewed Claude resources. Unsubscribe any time.