AI setup skill

What it is for

The setup-dev-manager skill is a SKILL.md file that tells an AI agent how to configure SnakeFlow automatically. It is located in the SnakeFlow repository under .cursor/skills/setup-dev-manager/.

When you ask the agent to configure SnakeFlow, it follows the skill and:

1. Scans the project — lockfiles, package.json, Docker Compose, ORM, scripts, monorepo layout
2. Infers sensible defaults — package manager, dev commands, ports, compose paths
3. Writes settings into .vscode/settings.json — all devManager.* keys in one place (servers, Quality Hub, containers, database tools, optional cloud toggles)

Use it when you want automatic, guided setup instead of copying JSON by hand — for example a new computer, a new clone of the repo, or onboarding a teammate.

---

How to install

Cursor

Cursor loads skills from a global or per-project skills/ directory inside .cursor/.

Global install (works in any workspace):

1. Copy the folder from your SnakeFlow clone:
   dev-environment-manager/.cursor/skills/setup-dev-manager/

2. Paste it into the global Cursor skills directory:

   OS	Path
   Windows	%USERPROFILE%\.cursor\skills\setup-dev-manager\
   macOS / Linux	~/.cursor/skills/setup-dev-manager/

3. Confirm the file exists: .../setup-dev-manager/SKILL.md

4. Reload Cursor (Ctrl+Shift+P → Developer: Reload Window).

Per-project install: copy the folder to <your-project>/.cursor/skills/setup-dev-manager/ and commit it so teammates get it on clone.

Antigravity

Antigravity uses .vscode/ instead of .cursor/ for its config directories. Place the skill folder under .vscode/skills/.

Global install (works in any workspace):

1. Copy the folder from your SnakeFlow clone:
   dev-environment-manager/.cursor/skills/setup-dev-manager/

2. Paste it into the global Antigravity skills directory:

   OS	Path
   Windows	%USERPROFILE%\.vscode\skills\setup-dev-manager\
   macOS / Linux	~/.vscode/skills/setup-dev-manager/

3. Confirm the file exists: .../setup-dev-manager/SKILL.md

4. Reload Antigravity (Ctrl+Shift+P → Developer: Reload Window).

Per-project install: copy the folder to <your-project>/.vscode/skills/setup-dev-manager/.

VS Code

Plain VS Code does not have a native skills system, but you can use the skill manually with any AI chat extension (GitHub Copilot Chat, Continue, etc.):

1. Open .cursor/skills/setup-dev-manager/SKILL.md from the SnakeFlow repo.
2. Copy its contents and paste them at the start of your conversation with the AI.
3. Ask it to configure SnakeFlow for your project.

The agent will follow the same instructions and write .vscode/settings.json for you.

Deploy the skill from the extension (one command)

If SnakeFlow is already installed, you can copy the bundled setup-dev-manager template into the current workspace without manual folder copy:

1. Command Palette → SnakeFlow: Deploy AI Skill to Project.
2. If the skill folder already exists, choose whether to overwrite.
3. The extension writes SKILL.md under your editor’s project config directory (.cursor/skills/setup-dev-manager/ in Cursor, or .vscode/skills/setup-dev-manager/ where that layout is used) — same structure as the manual install above.

Then reload the window if your product requires it, and ask your AI agent to configure SnakeFlow using the skill.

---

How to use it

1. Install the SnakeFlow extension (Installation).

2. Open your project root in your IDE.

3. In Chat / Agent, ask in natural language, for example:

   • «Set up SnakeFlow for this project»
   • «Configure Dev Environment Manager: detect servers, Docker, and quality checks»
   • «Scan the repo and write devManager settings to .vscode/settings.json»

The agent loads setup-dev-manager (by description match) and follows the skill: analyzes files, then proposes or applies .vscode/settings.json changes.

Caution

Always review generated JSON before committing — ports and script names are inferred and may need one manual tweak.

---

Related skills in this repo

Skill	Purpose
setup-dev-manager	Project autoconfiguration → .vscode/settings.json
rebuild-extension	Build and package the extension from source (contributors)

Both skill files are located under .cursor/skills/ in the SnakeFlow repository root.