Skip to content

[Feature] Version pinning and lock file (skillkit.lock) #91

Closed

Description

@rohitg00

Problem

SkillKit has no way to pin skill versions or ensure reproducible installs:

  • npm has package-lock.json, pip has requirements.txt, cargo has Cargo.lock
  • Two developers running skillkit install at different times get different skill versions
  • No rollback mechanism — can't revert to a known-good skill version
  • Product Hunt users flagged "embedding drift" as a concern when the semantic store grows

Proposed Solution

skillkit.lock

Auto-generated lock file tracking installed skill versions:

{
  "lockfileVersion": 1,
  "skills": {
    "pdf": {
      "source": "anthropics/skills",
      "version": "2.1.0",
      "integrity": "sha256-...",
      "installedAt": "2026-04-07T...",
      "agents": ["claude-code", "cursor"]
    }
  }
}

Commands

  • skillkit install — auto-generates/updates lock file
  • skillkit install --frozen — install from lock file only (CI mode), fail if lock is stale
  • skillkit update — updates lock file after re-fetching
  • skillkit pin <skill> --version <version> — pin specific version

Versioning

References

Activity

  1. rohitg00 commented on Apr 12, 2026

    @rohitg00
    OwnerAuthor

    Implemented in v1.21.0 (PR #105). SkillKit now has centralized ~/.skillkit/lock.json tracking all installed skills with source, checksum (SHA-256), agents, and timestamps. Written on install, updated on update, cleaned on remove. Checksums enable change detection — skillkit update skips unchanged skills automatically.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions