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.
Badge for your README
Markdown
[](/listings/railly--agentfiles)HTML
<a href="/listings/railly--agentfiles"><img src="/api/listings/railly--agentfiles/badge.svg" alt="findsafeskills safety rating" /></a>Install
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)
- # Agentfiles
- AI skills manager for Obsidian. Browse, create, and manage skills across Claude Code, Cursor, Codex, Windsurf, and 17 coding agents.
- **[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)
- 
- 
- ## Install
- ### 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
- ```bash
- 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 it does
- - **Browse** skills, commands, and agents from 17 tools in one place
- - **Search** by name or file content with deep search toggle
- - **Create** new skills with a stepped wizard (pick tool, type, name)
- - **Edit** skills inline with markdown preview and Cmd+S save
- - **Marketplace** — install skills from [skills.sh](https://skills.sh)
- - **Conversations** — browse Claude Code session history, search, tag, and export to vault
- - **Dashboard** — usage analytics, burn rate, context tax, health metrics (requires [skillkit](https://www.npmjs.com/package/@crafter/skillkit))
- ## Supported tools
- | Tool | Skills | Commands | Rules / Memories | Agents |
- |------|--------|----------|-------------------|--------|
- | Claude Code | `~/.claude/skills/` | `~/.claude/commands/` | | `~/.claude/agents/` |
- | Cursor | `~/.cursor/skills/` | | `~/.cursor/rules/` | `~/.cursor/agents/` |
- | Windsurf | `~/.codeium/windsurf/skills/` | | `~/.codeium/windsurf/memories/`, `~/.windsurf/rules/` | |
- | Codex | `~/.codex/skills/` | `~/.codex/prompts/` | `~/.codex/memories/` | `~/.codex/agents/` |
- | Copilot | `~/.copilot/skills/` | | | |
- | Amp | `$XDG_CONFIG/amp/skills/` | | | |
- | OpenCode | `$XDG_CONFIG/opencode/skills/` | | | |
- | Cline | detection only | | | |
- | Roo Code | `~/.roo/skills/` | | | |
- | Kilo Code | `~/.kilocode/skills/` | | | |
- | Continue | `~/.continue/skills/` | | | |
- | OpenHands | `~/.openhands/skills/` | | | |
- | Goose | `$XDG_CONFIG/goose/skills/` | | | |
- | Pi | `~/.pi/agent/skills/` | | | |
- | Antigravity | `~/.gemini/antigravity/skills/` | | | |
- | Global | `~/.agents/skills/` | | | |
- | Claude Desktop | detection only | | | |
- | Aider | detection only | | | |
- Desktop only (macOS, Windows, Linux) — reads files outside your vault.
- ## FAQ
- ### What is Agentfiles?
- 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).
- ### What can I do with Agentfiles?
- See [What it does](#what-it-does) above. Full feature list and screenshots: [agentfiles.crafter.run/docs](https://agentfiles.crafter.run/docs).
- ### What tools are supported?
- 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.
- ### How do I install Agentfiles?
- See [Install](#install) above.
- ### What is skillkit analytics?
- 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.
- ```bash
- bunx @crafter/skillkit@latest scan
- # npx alternative, with Bun installed:
- npx -y @crafter/skillkit@latest scan
- ```
- ## Security and permissions
- Agentfiles is desktop-only because its core purpose requires direct access to skill files outside the current vault.
- - **Filesystem:** reads supported agent directories and user-configured project paths. Writes happen only for explicit create, edit, install, update, or remove actions.
- - **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.
- - **Shell:** Agentfiles does not spawn processes or execute shell commands. Optional Skillkit actions are shown or copied for the user to run separately.
- - **Analytics:** Agentfiles reads `~/.skillkit/agentfiles-snapshot.json` through Skillkit's versioned programmatic API. The snapshot remains local.
- - **Network and telemetry:** Marketplace search, preview, and install use `skills.sh` and GitHub. Agentfiles sends no analytics or telemetry.
- - **Clipboard:** commands are copied only after an explicit button click.
- 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.
- ### Is Agentfiles free and open source?
- Yes, MIT licensed. See [LICENSE](LICENSE).
- ### Where can I get help?
- - [Obsidian Community](https://community.obsidian.md/plugins/agentfiles)
- - [Website](https://agentfiles.crafter.run)
- - [GitHub Issues](https://github.com/Railly/agentfiles/issues)
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.