Project Structure

xskill/
├── Cargo.toml
├── README.md
├── schemas/                # JSON Schema definitions
│   ├── xskill.schema.json    # settings.json schema
│   └── registry.schema.json  # registry index schema
├── docs/                   # Documentation source (mdbook input)
│   ├── SPEC.md             # Requirements specification
├── book/                   # mdbook output (generated)
│   ├── en/
│   └── zh/
├── crates/
│   └── generate-book/      # mdbook content generator
├── src/
│   ├── main.rs             # CLI entry point (clap derive)
│   ├── config.rs           # Configuration handling
│   ├── git.rs              # Git operations (clone, sparse checkout)
│   ├── lock.rs             # Lock file management
│   ├── skill_meta.rs       # SKILL.md frontmatter parsing
│   ├── cache.rs            # Cache data structures
│   ├── utils.rs            # Utility functions
│   └── commands/
│       ├── add.rs          # Install skills
│       ├── link.rs         # Symlink existing skills to platforms
│       ├── remove.rs       # Remove skills
│       ├── update.rs       # Update from lock file
│       ├── restore.rs      # Restore from lock file
│       ├── list.rs         # List installed skills
│       ├── find.rs         # Interactive TUI skill finder
│       ├── query.rs        # Query remote/cache skills
│       ├── sources.rs      # Manage sources (CRUD)
│       ├── platforms.rs    # List platforms
│       ├── rec.rs          # Manage recommended skills (list/add/remove)
│       ├── cache.rs        # Cache management
│       ├── config.rs       # Config management
│       └── new.rs          # Create skill project