Skip to content

feat(skills): install and remove only skill folders deepctl owns #124

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
dg-coreylweathers wants to merge 4 commits into
base: goal/bg-1-skills-bundle-fetch
Choose a base branch
from
Draft

feat(skills): install and remove only skill folders deepctl owns #124

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
b3d629e
feat(skills): install and remove only skill folders deepctl owns
dg-coreylweathers Oct 5, 2026
aa07edf
fix(skills): hold a skills.json lock across each tool's whole install…
dg-coreylweathers Oct 7, 2026
e678b4f
fix(skills): place folders with an atomic no-replace rename
dg-coreylweathers Oct 7, 2026
d1cf0f0
docs(readme): explain where skills go, the ownership rule and the req…
dg-coreylweathers Oct 7, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 21 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -291,14 +291,34 @@ Add to your editor's MCP config:

### AI Tool Integration

Automatically detect and configure AI coding assistants with Deepgram skills.
Install the Deepgram skills as folders in each AI coding assistant's skills folder.

```bash
dg skills status # Detect AI tools
dg skills setup # Interactive setup wizard
dg skills install --all # Install for all detected tools
dg skills update # Replace the folders deepctl installed
dg skills remove --all # Delete the folders deepctl installed
```

| Tool | Skills folder |
|---|---|
| Claude Code | `~/.claude/skills` |
| OpenAI Codex | `~/.agents/skills` |
| Gemini CLI | `~/.gemini/skills` |
| Cursor | `~/.cursor/skills` |
| OpenCode | `~/.config/opencode/skills` |
| Cline | `~/.cline/skills` |
| Amazon Q Developer, Aider | none: deepctl prints where to get the skills |

deepctl replaces or deletes a folder only if skills.json records it for that tool, it is a real folder directly in that tool's skills folder, it holds deepctl's `.deepctl-skill` marker, and its contents are exactly what deepctl installed. So folders from `npx skills add`, and symlinked skill folders, are left alone.

These commands abort if the filesystem cannot provide locking or no-replace directory moves. Installed skill folders and skills.json stay as they were, though the tool's skills folder and `~/.deepctl/skills/skills.json.lock` may already have been created. While another `dg skills` command is changing skills, the next one waits up to 30 seconds for it to finish.

If you edit a deepctl folder, or add a file or link to it, deepctl leaves it alone: `update` stops without changing anything and `remove` won't delete it. To get updates again, rename or move your edited copy, or delete it yourself. Opening a skill folder in Finder or Explorer can add `.DS_Store`, `Thumbs.db` or `desktop.ini`, which counts as an edit.

Files from deepctl 0.3.x, such as `~/.claude/commands/deepgram/*.md` and the rules files like `~/.cursor/rules/deepctl.mdc`, are currently kept, and `dg skills remove` doesn't delete them.

### Starter Apps

Scaffold a new project from Deepgram templates.
Expand Down
Loading
Loading