Skip to content
Back to search

agentfiles

Browse, create, and edit AI agent files across Claude Code, Cursor, Codex, and 12 coding tools — from Obsidian.

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/railly--agentfiles/badge.svg)](/listings/railly--agentfiles)

HTML

<a href="/listings/railly--agentfiles"><img src="/api/listings/railly--agentfiles/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

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

From Obsidian (one-click)

Open the deep link in your browser:

obsidian://show-plugin?id=agentfiles

Or open the community page first to see the scorecard and screenshots: **[community.obsidian.md/plugins/agentfiles](https://community.obsidian.md/plugins/agentfiles)**.

You can also search **Agentfiles** in Settings → Community plugins inside Obsidian.

Manual

1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/Railly/agentfiles/releases/latest) 2. Create `<vault>/.obsidian/plugins/agentfiles/` 3. Copy the three files into that folder 4. Enable in Settings → Community plugins

Optional: skillkit analytics

bunx @crafter/skillkit@latest scan

`npx -y @crafter/skillkit@latest scan` also works when Bun is installed and available on `PATH`. Skillkit uses the Bun runtime, so `npx` does not remove that requirement.

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.

README.md · README · 128 lines

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

  1. # Agentfiles
  2. AI skills manager for Obsidian. Browse, create, and manage skills across Claude Code, Cursor, Codex, Windsurf, and 17 coding agents.
  3. **[Open in Obsidian →](obsidian://show-plugin?id=agentfiles)** · [View on Obsidian Community](https://community.obsidian.md/plugins/agentfiles) · [Website](https://agentfiles.crafter.run) · [Latest release](https://github.com/Railly/agentfiles/releases/latest)
  4. ![Browse skills, commands, and agents across 17 coding assistants](assets/browse.jpeg)
  5. ![Dashboard with burn rate, context tax, and health metrics](assets/dashboard.jpeg)
  6. ## Install
  7. ### From Obsidian (one-click)
  8. Open the deep link in your browser:
  9. ```
  10. obsidian://show-plugin?id=agentfiles
  11. ```
  12. Or open the community page first to see the scorecard and screenshots: **[community.obsidian.md/plugins/agentfiles](https://community.obsidian.md/plugins/agentfiles)**.
  13. You can also search **Agentfiles** in Settings → Community plugins inside Obsidian.
  14. ### Manual
  15. 1. Download `main.js`, `manifest.json`, and `styles.css` from the [latest release](https://github.com/Railly/agentfiles/releases/latest)
  16. 2. Create `<vault>/.obsidian/plugins/agentfiles/`
  17. 3. Copy the three files into that folder
  18. 4. Enable in Settings → Community plugins
  19. ### Optional: skillkit analytics
  20. ```bash
  21. bunx @crafter/skillkit@latest scan
  22. ```
  23. `npx -y @crafter/skillkit@latest scan` also works when Bun is installed and available on `PATH`. Skillkit uses the Bun runtime, so `npx` does not remove that requirement.
  24. ## What it does
  25. - **Browse** skills, commands, and agents from 17 tools in one place
  26. - **Search** by name or file content with deep search toggle
  27. - **Create** new skills with a stepped wizard (pick tool, type, name)
  28. - **Edit** skills inline with markdown preview and Cmd+S save
  29. - **Marketplace** — install skills from [skills.sh](https://skills.sh)
  30. - **Conversations** — browse Claude Code session history, search, tag, and export to vault
  31. - **Dashboard** — usage analytics, burn rate, context tax, health metrics (requires [skillkit](https://www.npmjs.com/package/@crafter/skillkit))
  32. ## Supported tools
  33. | Tool | Skills | Commands | Rules / Memories | Agents |
  34. |------|--------|----------|-------------------|--------|
  35. | Claude Code | `~/.claude/skills/` | `~/.claude/commands/` | | `~/.claude/agents/` |
  36. | Cursor | `~/.cursor/skills/` | | `~/.cursor/rules/` | `~/.cursor/agents/` |
  37. | Windsurf | `~/.codeium/windsurf/skills/` | | `~/.codeium/windsurf/memories/`, `~/.windsurf/rules/` | |
  38. | Codex | `~/.codex/skills/` | `~/.codex/prompts/` | `~/.codex/memories/` | `~/.codex/agents/` |
  39. | Copilot | `~/.copilot/skills/` | | | |
  40. | Amp | `$XDG_CONFIG/amp/skills/` | | | |
  41. | OpenCode | `$XDG_CONFIG/opencode/skills/` | | | |
  42. | Cline | detection only | | | |
  43. | Roo Code | `~/.roo/skills/` | | | |
  44. | Kilo Code | `~/.kilocode/skills/` | | | |
  45. | Continue | `~/.continue/skills/` | | | |
  46. | OpenHands | `~/.openhands/skills/` | | | |
  47. | Goose | `$XDG_CONFIG/goose/skills/` | | | |
  48. | Pi | `~/.pi/agent/skills/` | | | |
  49. | Antigravity | `~/.gemini/antigravity/skills/` | | | |
  50. | Global | `~/.agents/skills/` | | | |
  51. | Claude Desktop | detection only | | | |
  52. | Aider | detection only | | | |
  53. Desktop only (macOS, Windows, Linux) — reads files outside your vault.
  54. ## FAQ
  55. ### What is Agentfiles?
  56. An AI skills manager for Obsidian. Browse, create, and manage skills, commands, and agents across 17 coding agents, all from your vault. Full docs: [agentfiles.crafter.run/docs](https://agentfiles.crafter.run/docs).
  57. ### What can I do with Agentfiles?
  58. See [What it does](#what-it-does) above. Full feature list and screenshots: [agentfiles.crafter.run/docs](https://agentfiles.crafter.run/docs).
  59. ### What tools are supported?
  60. See [Supported tools](#supported-tools) above: 17 tools including Claude Code, Cursor, Codex, Windsurf, Copilot, Amp, OpenCode, Cline, Roo Code, Kilo Code, Continue, OpenHands, Goose, Pi, Antigravity, Claude Desktop, Aider, and a global `~/.agents/skills/` directory.
  61. ### How do I install Agentfiles?
  62. See [Install](#install) above.
  63. ### What is skillkit analytics?
  64. Optional local analytics for the Dashboard's usage metrics, burn rate, context tax, and health. Agentfiles imports Skillkit's portable API and reads a versioned snapshot. It never executes the Skillkit CLI.
  65. ```bash
  66. bunx @crafter/skillkit@latest scan
  67. # npx alternative, with Bun installed:
  68. npx -y @crafter/skillkit@latest scan
  69. ```
  70. ## Security and permissions
  71. Agentfiles is desktop-only because its core purpose requires direct access to skill files outside the current vault.
  72. - **Filesystem:** reads supported agent directories and user-configured project paths. Writes happen only for explicit create, edit, install, update, or remove actions.
  73. - **Marketplace:** searches `skills.sh`, resolves the selected source through the GitHub API, pins downloads to a commit SHA, rejects path traversal, and limits each install to 200 files and 10 MB.
  74. - **Shell:** Agentfiles does not spawn processes or execute shell commands. Optional Skillkit actions are shown or copied for the user to run separately.
  75. - **Analytics:** Agentfiles reads `~/.skillkit/agentfiles-snapshot.json` through Skillkit's versioned programmatic API. The snapshot remains local.
  76. - **Network and telemetry:** Marketplace search, preview, and install use `skills.sh` and GitHub. Agentfiles sends no analytics or telemetry.
  77. - **Clipboard:** commands are copied only after an explicit button click.
  78. The Obsidian scorecard can still identify direct filesystem access as a risk capability. That capability is required for Agentfiles to manage skills across desktop coding agents. It is disclosed here so users can review the exact scope.
  79. ### Is Agentfiles free and open source?
  80. Yes, MIT licensed. See [LICENSE](LICENSE).
  81. ### Where can I get help?
  82. - [Obsidian Community](https://community.obsidian.md/plugins/agentfiles)
  83. - [Website](https://agentfiles.crafter.run)
  84. - [GitHub Issues](https://github.com/Railly/agentfiles/issues)
  85. ## License
  86. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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