obsidian-plugin/railly_agentfiles
1
0
Fork 0
mirror of https://github.com/railly/agentfiles.git synced 2026-07-22 14:30:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
23 commits 4 branches 16 tags 1.1 MiB
TypeScript 84.4%
CSS 14.9%
JavaScript 0.7%
Find a file
Michael Leydon fcd77ef70e feat: add project-level skill scanning and Projects sidebar filter 
Scan all directories under a configurable home folder for project-level
skills (.claude/skills, .codex/skills, .cursor/skills, etc.) and display
them grouped by project in a new "Projects" sidebar section.

- Add projectScanEnabled and projectsHomeDir settings
- Scan ~/project/.tool/skills for each installed tool using the tool's
  own path config (correct tool attribution)
- Add Projects section to sidebar with per-project filtering
- Show absolute file path in frontmatter detail view
- Skip .Trash, Library, and other system dirs to avoid EPERM crashes
- Try/catch per-project scan so one failure doesn't kill the rest

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-29 14:44:47 -05:00
src feat: add project-level skill scanning and Projects sidebar filter 2026-03-29 14:44:47 -05:00
.gitignore feat: initial release - AI agent skills manager for Obsidian 2026-03-28 08:18:28 -05:00
bun.lock feat: initial release - AI agent skills manager for Obsidian 2026-03-28 08:18:28 -05:00
esbuild.config.mjs feat: initial release - AI agent skills manager for Obsidian 2026-03-28 08:18:28 -05:00
LICENSE feat: rename to Agentfiles, add release files 2026-03-28 08:40:21 -05:00
main.js feat: add project-level skill scanning and Projects sidebar filter 2026-03-29 14:44:47 -05:00
manifest.json fix: address all obsidian-releases review issues 2026-03-28 12:40:17 -05:00
package.json fix: address all obsidian-releases review issues 2026-03-28 12:40:17 -05:00
README.md docs: update README with dashboard, badges, and skillkit integration 2026-03-28 12:41:57 -05:00
styles.css feat: health + context tax in two-column layout, responsive dashboard 2026-03-28 12:33:58 -05:00
tsconfig.json feat: initial release - AI agent skills manager for Obsidian 2026-03-28 08:18:28 -05:00
versions.json fix: address all obsidian-releases review issues 2026-03-28 12:40:17 -05:00

README.md

Agentfiles

Discover, organize, and edit AI agent skills, commands, and agents across Claude Code, Cursor, Codex, Windsurf, and more — from inside Obsidian.

Features

  • Multi-tool discovery — Scans 13 tools: Claude Code, Cursor, Windsurf, Codex, Copilot, Amp, OpenCode, Aider, and more
  • Three-column view — Sidebar filters, skill list with search, and detail panel with markdown preview
  • Built-in editor — Edit skills in place with Cmd+S save
  • Real-time file watching — Automatically detects changes to skill files
  • Full-text search — Search across skill names, descriptions, and content
  • Frontmatter metadata — View parsed YAML properties at a glance
  • Token estimation — See character count and estimated token usage per skill
  • Tool logos — Real SVG logos for each supported coding agent
  • Favorites & collections — Organize skills your way
  • Symlink deduplication — Same skill installed in multiple tools shows once

Skillkit dashboard

Agentfiles includes a built-in analytics dashboard powered by skillkit. Click Dashboard in the sidebar to see:

  • Overview — Total invocations, active skills, installed count, stale count
  • Top skills — Bar chart of your most-used skills over the last 30 days
  • Health — Donut chart of active vs unused skills, metadata budget usage
  • Burn rate — Daily cost chart, model breakdown, session count, API calls
  • Context tax — Stacked bar showing how CLAUDE.md, skills metadata, and memory split your context window, with per-session cost estimates and cache savings
  • Stale skills — List of skills never triggered in 30 days with skillkit prune hint

Usage badges also appear on individual skill cards:

  • Use count (blue badge)
  • STALE (red) — not triggered in 30+ days
  • HEAVY (yellow) — content exceeds 5k characters

Install skillkit to enable:

npm i -g @crafter/skillkit && skillkit scan

Without skillkit, the plugin works normally for browsing and editing — the dashboard and badges are optional.

Supported tools

Tool Skills Commands Agents
Claude Code ~/.claude/skills/ ~/.claude/commands/ ~/.claude/agents/
Cursor ~/.cursor/skills/ ~/.cursor/agents/
Codex ~/.codex/skills/ ~/.codex/agents/
Windsurf ~/.codeium/windsurf/memories/
Copilot ~/.copilot/skills/
Amp ~/.config/amp/skills/
OpenCode ~/.config/opencode/skills/
Global ~/.agents/skills/

Installation

Search Agentfiles in Obsidian's Community plugins browser, or install manually:

  1. Download main.js, manifest.json, and styles.css from the latest release
  2. Create .obsidian/plugins/agentfiles/ in your vault
  3. Copy the three files into that folder
  4. Enable the plugin in Settings > Community plugins

Usage

  1. Click the CPU icon in the ribbon, or run Agentfiles: Open from the command palette
  2. Browse skills by tool or type in the sidebar
  3. Click any skill to preview its content
  4. Click the pencil icon to edit, Cmd+S to save
  5. Click Dashboard for analytics (requires skillkit)

Desktop only

This plugin requires desktop Obsidian (macOS, Windows, Linux) because it reads files outside your vault.

License

MIT