Platform Detection

The CLI automatically detects which agent platform you’re using and installs skills to the correct directory.

Detection logic

The CLI checks for platform-specific directories in the current working directory:

if .claude/ exists     → Claude Code
else if .cursor/ exists → Cursor
else if .windsurf/ exists → Windsurf
else                    → Generic

Detection happens during skillett login and skillett setup. The detected platform is saved to SKILLETT_PLATFORM in the local .env file.

Paths by platform

Core skill

Platform	Path
Claude Code	.claude/skills/skillett/SKILL.md
Cursor	.cursor/rules/skillett/SKILL.md
Windsurf	.windsurf/rules/skillett/SKILL.md
Generic	.skillett/skills/skillett/SKILL.md

Integration skills (via skillett pull)

Platform	Path
Claude Code	.claude/skills/skillett-<slug>/
Cursor	.cursor/rules/skillett-<slug>/
Windsurf	.windsurf/rules/skillett-<slug>/
Generic	.skillett/skills/<slug>/

Environment file

Platform	Path
Claude Code	.claude/.env
Cursor	.cursor/.env
Windsurf	.windsurf/.env
Generic	.skillett/.env

Re-detecting

If you switch platforms or the detection was wrong, re-run setup:

skillett setup

This re-detects the platform and moves the core skill to the correct directory.

Custom paths

Use --path with skillett pull to override the default directory:

skillett pull github --path ./my-custom-skills/github/

How agents find skills

Each platform has its own convention for discovering skill files:

• Claude Code — Reads all .md files in .claude/skills/ subdirectories
• Cursor — Reads rule files from .cursor/rules/ subdirectories
• Windsurf — Reads rule files from .windsurf/rules/ subdirectories

The core skill acts as the initial entry point — when the agent reads it, it learns that skillett CLI commands are available and starts using them.