Skip to main content

lovstudio-skill-helper

CLI helper for Lovstudio paid skills — use a Lovstudio account entitlement or a legacy license to transparently decrypt/run protected skills locally. Decryption keys are fetched per-invocation and live only in process memory; they never touch disk.

Install

The canonical way is via uv — no install step needed, runs on first use:

uvx lovstudio-skill-helper login

The npm lovstudio skills add <name> command signs in and redeems Credits before installing a paid encrypted bundle. The helper then uses the same account entitlement when the Agent asks to decrypt the Skill.

Or install it persistently:

pipx install lovstudio-skill-helper

Usage

# account login (the npm CLI can start this flow automatically)
lovstudio-skill-helper login

# legacy license path, one-time per device
lovstudio-skill-helper activate <license-key>

# then any paid skill placeholder SKILL.md will call:
lovstudio-skill-helper decrypt <skill-name>       # print plaintext SKILL.md to stdout
lovstudio-skill-helper exec <skill-name> <script> # run an encrypted script once

lovstudio-skill-helper status           # show current activation
lovstudio-skill-helper heartbeat        # refresh last-seen
lovstudio-skill-helper deactivate       # wipe local license

How it works

Paid skills ship as AES-256-GCM ciphertext under the installer-owned directory created by npx skills add ..., normally ~/.agents/skills/lov-<name>/, with optional Agent-specific copies or links such as ~/.codex/skills/... and ~/.claude/skills/.... Current and legacy directory names remain discoverable. Each call to decrypt / exec:

  1. Uses the signed-in Lovstudio account entitlement created by a Credits redemption.
  2. Falls back to the legacy license path for existing users.
  3. Returns a per-skill-version AES key only after the server verifies entitlement.
  4. Decrypts in memory, streams to stdout or a tempfile.TemporaryDirectory that is wiped on exit.

License keys are sold via the 手工川 (ShougongChuan) WeChat official account.

License

MIT.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lovstudio_skill_helper-0.9.3.tar.gz (43.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

lovstudio_skill_helper-0.9.3-py3-none-any.whl (26.8 kB view details)

Uploaded Python 3

File details

Details for the file lovstudio_skill_helper-0.9.3.tar.gz.

File metadata

File hashes

Hashes for lovstudio_skill_helper-0.9.3.tar.gz
Algorithm Hash digest
SHA256 f87c607cdffb528543375cc5efd080ed897831c77481ad642c30fbc7ca3f89e8
MD5 b790002b90a6c0e9ceb294fdb995d184
BLAKE2b-256 f270aae72d73fbfffd24d9369d76e07eee42cc8732a6fdc8f6ba9dbe5a6cb3fb

See more details on using hashes here.

File details

Details for the file lovstudio_skill_helper-0.9.3-py3-none-any.whl.

File metadata

File hashes

Hashes for lovstudio_skill_helper-0.9.3-py3-none-any.whl
Algorithm Hash digest
SHA256 59a73c2306f3779763cbf703cb53c4f225dcd378c99b1d8495be3458c7e124e3
MD5 9680ab8c6f1d6185f577b2e762940af2
BLAKE2b-256 c8b6c74e0de3bd9cda7b40fa9769345f092dfb5c9f217ffbdeae14e37f30935d

See more details on using hashes here.

Release history Release notifications | RSS feed

0.9.4

2 files

This release

0.9.3 This release

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.6.8

2 files

0.6.7

2 files

0.6.6

2 files

0.6.5

2 files

0.6.4

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.0

2 files

0.4.0

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page