Agentfiles is available in the Obsidian Community Plugins directory.

Or use the deep link: obsidian://show-plugin?id=agentfiles

Manual install

# Download latest release assets
curl -L https://github.com/Railly/obsidian-agent-skills/releases/latest/download/main.js \
  -o ~/.obsidian/plugins/agentfiles/main.js
curl -L https://github.com/Railly/obsidian-agent-skills/releases/latest/download/manifest.json \
  -o ~/.obsidian/plugins/agentfiles/manifest.json
curl -L https://github.com/Railly/obsidian-agent-skills/releases/latest/download/styles.css \
  -o ~/.obsidian/plugins/agentfiles/styles.css

Once installed, open the Agentfiles panel from the left sidebar ribbon or via the command palette.

The scanner will automatically discover all skills, commands, and agents from supported tools on your system. No configuration required for the default paths.

# Skills are discovered from paths like:
~/.claude/skills/       # Claude Code skills
~/.claude/commands/     # Claude Code commands
~/.claude/agents/       # Claude Code agents
~/.cursor/skills/       # Cursor skills
~/.codex/skills/        # Codex skills
~/.codeium/windsurf/memories/  # Windsurf memories

Use the search bar to filter by name or toggle Deep Search to search inside file content.

• Obsidian v1.4.11 or later
• Desktop only — macOS, Windows, or Linux (reads files outside your vault)
• skillkit (optional) — required for Dashboard analytics

The scanner reads your filesystem for skill files across all configured tool directories. It runs on startup and whenever the file watcher detects changes.

Each skill is parsed for its YAML frontmatter (name, description, tool, type) and displayed in the unified list. Skills without frontmatter are still shown using their filename as the label.

You can filter by tool, type (skill / command / agent), or search by name and content.

Clicking any skill opens it in the built-in CM6 editor. The editor provides:

• Syntax highlighting for Markdown and YAML frontmatter
• YAML linter with inline error markers for invalid frontmatter
• Foldable frontmatter — collapse the --- block to focus on content
• Cmd+S / Ctrl+S to save changes directly to disk

The editor writes directly to the skill file on disk. Changes are reflected immediately in the panel.

The Marketplace tab connects to skills.sh to browse community-contributed skills.

When you click Install on a skill, you choose which tool directory to install it into. The file is written directly to the correct path.

Agentfiles watches all configured skill directories for changes using the native filesystem events API. When a skill file is added, modified, or deleted externally (e.g., by a CLI tool), the panel updates automatically.

The watcher starts when the plugin loads and stops when Obsidian closes. No manual refresh needed.

The Conversations view reads Claude Code session transcripts from ~/.claude/projects/ and presents them as a searchable list.

• Search across all session content
• Tag sessions for later reference
• Export a session as a permanent note in your vault

Transcripts are parsed from the JSONL format Claude Code uses to store conversation history.

The Dashboard requires the skillkit CLI to be installed and to have run at least one scan.

npm i -g @crafter/skillkit
skillkit scan

Once data is available, the Dashboard shows burn rate (tokens/day), context tax (% of context used by skills), and health metrics per skill.

Skills are plain Markdown files with optional YAML frontmatter. The frontmatter is used by Agentfiles for display and filtering.

---
name: ship
description: Commit staged changes with a conventional commit message
tool: claude
type: skill
version: 1.0.0
---

When asked to ship or commit:

1. Run `git status` to see staged files
2. Analyze the diff with `git diff --staged`
3. Write a conventional commit message (feat/fix/chore/docs/refactor)
4. Run `git commit -m "..."`

Follow the project's existing commit style. Never skip hooks.

Supported frontmatter fields:

All fields are optional. Skills without frontmatter work fine — Agentfiles uses the filename as the display name.

Open Settings → Agentfiles to configure the plugin.

• Custom paths — add additional directories to scan beyond the defaults
• Excluded paths — glob patterns to ignore
• skillkit path — override the default skillkit binary location

skillkit is a companion CLI that provides analytics data for the Dashboard. It is optional and not required for the core skill management features.

# Install globally
npm i -g @crafter/skillkit

# Run a scan (generates data for the Dashboard)
skillkit scan

# View usage report
skillkit report

skillkit reads Claude Code session JSONL files and computes token usage, burn rate, and context tax per skill. The data is stored locally and never sent to any server.