How noviadi/sikil works
Sikil is a Rust CLI for discovering and managing Agent Skills across several coding agents. The main workflow is to scan configured agent locations, parse skill metadata, report installations and conflicts, then install, synchronize, adopt, unmanage, validate, or remove skills. Commands coordinate domain logic and filesystem operations, with shared configuration, cache, manifest/provenance, and output support. The README documents the overall layering and capabilities; source relationships below are limited to those visible in excerpts or the source index.
Main entry points: scanner.rs Skill scanner · app.rs CLI dispatch · install.rs Install · atomic.rs Atomic operations
Components 23
CLI and commands
- CLI dispatch
src/cli/app.rs - Install
src/commands/install.rs - List and conflicts
src/commands/list.rs - Show details
src/commands/show.rs - Adopt skills
src/commands/adopt.rs - Synchronize
src/commands/sync.rs - Validate
src/commands/validate.rs - Remove
src/commands/remove.rs - Unmanage
src/commands/unmanage.rs
Skill domain
- Skill scanner
src/core/scanner.rs - Metadata parser
src/core/parser.rs - Skill model
src/core/skill.rs - Conflict detection
src/core/conflicts.rs - Project manifest
src/core/manifest.rs - Skill provenance
src/core/provenance.rs
Filesystem operations
- Git acquisition
src/utils/git.rs - Symlink manager
src/utils/symlink.rs - Atomic operations
src/utils/atomic.rs - Path utilities
src/utils/paths.rs
Shared support
- Agent configuration
src/core/config.rs - Scan cache
src/core/cache.rs - CLI output
src/cli/output.rs
Other components
- CLI user
Connections 39
- CLI user → CLI dispatch: invokes
README.md - CLI dispatch → Install: dispatches
- CLI dispatch → List and conflicts: dispatches
- CLI dispatch → Show details: dispatches
- CLI dispatch → Adopt skills: dispatches
- CLI dispatch → Synchronize: dispatches
- CLI dispatch → Validate: dispatches
- CLI dispatch → Remove: dispatches
- CLI dispatch → Unmanage: dispatches
- Install → Git acquisition: fetches from
src/commands/install.rs - Install → Metadata parser: parses skill
src/commands/install.rs - Install → Atomic operations: writes safely
src/commands/install.rs - Install → Symlink manager: links installs
src/commands/install.rs - Install → Agent configuration: reads settings
src/commands/install.rs - List and conflicts → Skill scanner: scans locations
src/commands/list.rs - List and conflicts → Conflict detection: checks conflicts
src/commands/list.rs - List and conflicts → Agent configuration: reads settings
src/commands/list.rs - List and conflicts → CLI output: formats results
src/commands/list.rs - Skill scanner → Metadata parser: parses entries
src/core/scanner.rs - Skill scanner → Scan cache: reads and writes
src/core/scanner.rs - Skill scanner → Skill model: builds models
src/core/scanner.rs - Skill scanner → Agent configuration: uses settings
src/core/scanner.rs - Skill scanner → Symlink manager: checks links
src/core/scanner.rs - Show details → Skill scanner: finds installation
src/commands/show.rs - Show details → Skill model: uses model
src/commands/show.rs - Adopt skills → Skill scanner: locates skills
src/commands/adopt.rs - Adopt skills → Atomic operations: moves safely
src/commands/adopt.rs - Adopt skills → Symlink manager: links installs
src/commands/adopt.rs - Synchronize → Symlink manager: updates links
src/commands/sync.rs - Synchronize → Agent configuration: reads settings
src/commands/sync.rs - Validate → Metadata parser: validates metadata
src/commands/validate.rs - Validate → Skill scanner: finds installed skill
src/commands/validate.rs - Remove → Skill scanner: locates installs
src/commands/remove.rs - Remove → Atomic operations: removes safely
src/commands/remove.rs - Unmanage → Skill scanner: locates installs
src/commands/unmanage.rs - Unmanage → Atomic operations: updates safely
src/commands/unmanage.rs - Project manifest → Atomic operations: writes atomically
src/core/manifest.rs - Skill provenance → Project manifest: uses manifest
src/core/provenance.rs - Skill provenance → Atomic operations: writes safely
src/core/provenance.rs