Skills
dg skills installs the Deepgram skills as folders in each AI coding tool’s skills folder, so the tool can load Deepgram reference material on demand. It writes and deletes folders in your home directory; this page lists what it touches.
Commands
setup, install, and update accept --ref to install another git ref of deepgram/skills; setup --all installs for every detected tool without prompting.
Skills folder per tool
Amazon Q Developer and Aider have no skills folder; the CLI prints where to get the skills.
Pinned bundle
By default, the CLI installs deepgram-skills-v1.8.0, pinned by commit and checked against the tarball’s SHA-256. To install another ref, pass --ref or set DEEPCTL_SKILLS_REF.
Which folders the CLI changes
The CLI replaces or deletes a skill folder only when all of these hold:
~/.deepctl/skills/skills.jsonrecords the folder for that tool.- It is a real folder directly in the tool’s skills folder.
- It holds the
.deepctl-skillmarker. - Its contents still match what the CLI installed.
As a result:
- Folders from
npx skills addand symlinked skill folders are left alone. - An edit freezes a folder:
updatestops without changing anything andremoveleaves it in place. Opening a folder in Finder or Explorer can add.DS_Store,Thumbs.db, ordesktop.ini, which counts as an edit. - To get updates again, rename or move the edited copy, or delete it yourself.
Other commands that install skills
dg login offers to install the skills, and dg plugin install, update, and remove refresh the installed ones. A skills failure prints a warning on stderr and leaves the command’s exit code unchanged.
Concurrent runs
While another dg skills, dg login, or dg plugin command is changing skills, the next one waits up to 30 seconds. If the first is still running after 30 seconds, the second stops, changes nothing, and says to run the command again.
On a filesystem that cannot provide locking or no-replace directory moves, these commands abort. Installed skill folders and skills.json stay as they were, though the tool’s skills folder and ~/.deepctl/skills/skills.json.lock may already exist.
Upgrading from 0.2.16 through 0.3.x
On macOS and Linux, once the CLI has installed a tool’s skill folders, it removes the files earlier releases wrote for that tool and prints which ones on stderr:
~/.claude/commands/deepgram/*.md,~/.cursor/rules/deepctl.mdc, and~/.cline/rules/deepctl.md- In
~/.codex/instructions.md,~/.gemini/GEMINI.md, and~/.opencode/agents.md, the section between the<!-- BEGIN deepctl CLI Referenceand<!-- END deepctl CLI Reference -->lines, including anything you changed inside it. The rest of each file is kept.
The CLI keeps each original file next to it as .deepctl-kept-v03-*. It removes a file only when its content exactly matches a deepgram/skills version an earlier release copied; it keeps a file you edited, a link, and a file reached through a link. On Windows, the CLI leaves this content untouched; remove it yourself if you do not need it.
First-run hint
When the CLI detects an AI coding tool and no skills are installed, it prints a one-time hint on stderr. The hint is suppressed in CI and when the CLI runs through uvx or pipx run.
Install without the CLI
npx skills add deepgram/skills installs the same skills without dg, and Agentic Developer Tools covers the Claude Code plugin marketplace route.