How mohssinehakimpro-maker/skills works
skills is a CLI and programmatic API for discovering, fetching, and managing reusable agent instructions across many coding agents. The main install path resolves a source, discovers skills, selects target agents and skills, then writes them into agent-compatible locations while maintaining lock state. Other documented workflows include find, list, use, update, remove, init, and experimental sync/install. Several command implementations are unsampled; their nodes are retained from the README, but speculative internal links are omitted.
Main entry points: add.ts Add skills · index.ts Public API · agents.ts Agent definitions · installer.ts Install skills
Components 23
Entry points
- CLI commands
src/cli.ts - Public API
src/index.ts - API configuration
src/api/config.ts
Source discovery
- Find skills
src/find.ts - Parse source
src/source-parser.ts - Source providers
src/providers/wellknown.ts - Git retrieval
src/git.ts
Skill management
- Add skills
src/add.ts - Discover skills
src/skills.ts - Install skills
src/installer.ts - List skills
src/list.ts - Use skill
src/use.ts - Update skills
src/update.ts - Remove skills
src/remove.ts - Dependency sync
src/sync.ts
Agent integration
- Agent definitions
src/agents.ts - Detect agents
src/detect-agent.ts
Shared services
- Project lockfile
src/local-lock.ts - Skill lock state
src/skill-lock.ts - Diagnostics
src/diagnostics.ts - Telemetry
src/telemetry.ts
Other components
- Developer
- Skills telemetry
Connections 27
- Developer → CLI commands: runs commands
- Developer → Public API: calls API
- Public API → API configuration: resolves settings
src/api/config.ts - Public API → Add skills: installs via
- Public API → List skills: lists via
- Public API → Remove skills: removes via
- Public API → Parse source: resolves sources
- Add skills → Parse source: parses source
src/add.ts - Add skills → Source providers: fetches from
src/add.ts - Add skills → Discover skills: discovers skills
src/add.ts - Add skills → Install skills: installs selected
src/add.ts - Add skills → Agent definitions: targets agents
src/add.ts - Add skills → Project lockfile: updates lockfile
src/add.ts - Add skills → Skill lock state: reads selection
src/add.ts - Add skills → Telemetry: tracks install
src/add.ts - Parse source → Git retrieval: checks commits
src/source-parser.ts - Source providers → Discover skills: provides skills
src/providers/wellknown.ts - Install skills → Agent definitions: uses agent paths
src/installer.ts - Install skills → Discover skills: parses skill files
src/installer.ts - API configuration → Agent definitions: validates agents
src/api/config.ts - Detect agents → Agent definitions: detects supported agents
src/detect-agent.ts - Dependency sync → Add skills: adds synced skills
src/sync.ts - Update skills → Add skills: reinstalls updates
src/update.ts - Update skills → Skill lock state: reads lock state
src/update.ts - Remove skills → Project lockfile: updates lockfile
src/remove.ts - Remove skills → Skill lock state: updates selection
src/remove.ts - Telemetry → Skills telemetry: sends events