11# Agentfiles
22
3- Discover, organize, and edit AI agent skills, commands , and agents across Claude Code, Cursor, Codex, Windsurf, and more — from inside Obsidian .
3+ AI skills manager for Obsidian. Browse, create , and manage skills across Claude Code, Cursor, Codex, Windsurf, and 10+ coding agents .
44
55![ Browse skills, commands, and agents across 13+ coding assistants] ( assets/browse.jpeg )
66
77![ Dashboard with burn rate, context tax, and health metrics] ( assets/dashboard.jpeg )
88
9- ## Features
10-
11- ### Skill browser
12- - Multi-tool discovery across 13+ coding agents
13- - Three-column layout: sidebar filters, skill list, detail panel
14- - Search by skill name with instant filtering
15- - Filter by status: stale, heavy, oversized, conflict
16- - Sort by name or usage count
17- - Symlink-aware scanning (follows symlinked skill directories)
18- - Project-level skill scanning (auto-detects vault's ` .claude/skills/ ` )
19- - Name-based deduplication across tools
20-
21- ### Detail panel
22- - Markdown preview with syntax-highlighted code blocks
23- - Built-in editor with Cmd+S save
24- - Frontmatter metadata display
25- - File path, size, character count, token estimation
26- - Warnings: oversized skills (>500 lines), long descriptions (>1024 chars)
27- - Usage sparkline (30-day daily trend)
28- - Conflict detection with similarity scores
29- - Execution traces (last 5 with model, tokens, cost, duration)
30- - Remove skill button with confirmation dialog
31-
32- ### Marketplace
33- - Browse and search skills from [ skills.sh] ( https://skills.sh ) registry
34- - Popular skills on first load (cached across sessions)
35- - Skill content preview with markdown rendering
36- - Install modal with agent selection (17 agents), scope toggle (project/global), and SVG logos
37- - Uninstall with lock file and copy cleanup
38- - Persistent install preferences across sessions
39- - Configurable package runner (auto/npx/bunx)
40-
41- ### Dashboard (requires [ skillkit] ( https://www.npmjs.com/package/@crafter/skillkit ) )
42- - Overview: invocations, active skills, installed count, stale count
43- - Streaks: current and longest streak with "on fire" badge
44- - Weekly velocity: cost comparison vs last week with change percentage
45- - Top skills: bar chart of most-used skills (30 days)
46- - Health: donut chart of active vs unused, metadata budget bar
47- - Burn rate: daily cost chart, model breakdown, session and API call counts
48- - Context tax: stacked bar (CLAUDE.md + skills metadata + memory), per-session cost, cache savings
49- - Stale skills list
50- - Action buttons: update skills, scan sessions, prune stale (with confirmation)
51- - Disk-cached data for instant load on Obsidian restart
52- - Manual refresh only (no blocking auto-refresh)
53-
54- ### Badges on skill cards
55- - Use count (blue)
56- - ** STALE** (red) — not triggered in 30+ days
57- - ** HEAVY** (yellow) — content exceeds 5k characters
58- - ** OVERSIZED** (orange) — more than 500 lines
59- - ** CONFLICT** (red) — overlaps with other skills
60-
61- ### Tool logos
62- Real SVG logos for: Claude Code, Cursor, Windsurf, Codex, GitHub Copilot, OpenCode, Goose, Cline, Continue, Roo Code, Replit, Gemini CLI. Striped placeholder for agents without logos.
9+ ## Install
10+
11+ ### From Obsidian (coming soon)
12+
13+ Search ** Agentfiles** in Settings > Community plugins.
14+
15+ ### Manual
16+
17+ ``` bash
18+ # Option A: Download from GitHub
19+ # 1. Get main.js, manifest.json, styles.css from the latest release
20+ # 2. Copy to <vault>/.obsidian/plugins/agentfiles/
21+ # 3. Enable in Settings > Community plugins
22+
23+ # Option B: Using skillkit
24+ npm i -g @crafter/skillkit
25+ skillkit scan
26+ ```
27+
28+ ## What it does
29+
30+ - ** Browse** skills, commands, and agents from 13+ tools in one place
31+ - ** Search** by name or file content with deep search toggle
32+ - ** Create** new skills with a stepped wizard (pick tool, type, name)
33+ - ** Edit** skills inline with markdown preview and Cmd+S save
34+ - ** Marketplace** — install skills from [ skills.sh] ( https://skills.sh )
35+ - ** Conversations** — browse Claude Code session history, search, tag, and export to vault
36+ - ** Dashboard** — usage analytics, burn rate, context tax, health metrics (requires [ skillkit] ( https://www.npmjs.com/package/@crafter/skillkit ) )
6337
6438## Supported tools
6539
@@ -74,34 +48,7 @@ Real SVG logos for: Claude Code, Cursor, Windsurf, Codex, GitHub Copilot, OpenCo
7448| OpenCode | ` ~/.config/opencode/skills/ ` | | |
7549| Global | ` ~/.agents/skills/ ` | | |
7650
77- ## Installation
78-
79- Search ** Agentfiles** in Obsidian's Community plugins browser, or install manually:
80-
81- 1 . Download ` main.js ` , ` manifest.json ` , and ` styles.css ` from the [ latest release] ( https://github.com/Railly/agentfiles/releases )
82- 2 . Create ` .obsidian/plugins/agentfiles/ ` in your vault
83- 3 . Copy the three files into that folder
84- 4 . Enable the plugin in Settings > Community plugins
85-
86- ## Usage
87-
88- 1 . Click the CPU icon in the ribbon, or run ** Agentfiles: Open** from the command palette
89- 2 . Browse skills by tool, type, or project in the sidebar
90- 3 . Click any skill to preview its content and metadata
91- 4 . Click the pencil icon to edit, Cmd+S to save
92- 5 . Click ** Dashboard** for analytics (requires skillkit)
93- 6 . Click ** Marketplace** to browse and install skills from skills.sh
94-
95- ## Settings
96-
97- - ** File watching** — auto-detect changes to skill files
98- - ** Project scanning** — scan directories for project-level skills
99- - ** Package runner** — choose between auto-detect, npx, or bunx for marketplace installs
100- - ** Tool toggles** — enable/disable individual coding agents
101-
102- ## Desktop only
103-
104- This plugin requires desktop Obsidian (macOS, Windows, Linux) because it reads files outside your vault.
51+ Desktop only (macOS, Windows, Linux) — reads files outside your vault.
10552
10653## License
10754
0 commit comments