skillshare v0.19.9 Release Notes

Release date: 2026-05-11

TL;DR

Context cost visibility — skillshare sync now reports token usage per target so you can see how much context each AI tool is consuming
Configurable budget warnings — set thresholds in config.yaml; sync and analyze warn when targets exceed your token budget
HTTP install fix — skillshare install now works with http:// protocol URLs

Context Cost Summary

After every sync, a one-line summary shows how many tokens each target loads. Targets with identical counts are grouped together:

✔ Synced 47 skill(s) to 4 target(s) in 312ms
  Context: ~12.4K always-loaded · ~58.2K on-demand (claude, cursor, codex, opencode)

Always-loaded tokens are skills the AI reads on every conversation start. On-demand tokens are skills loaded only when triggered. This helps you understand the real cost of your skill library.

The summary is also available in JSON output (--json) under the context_cost field. Use --quiet / -q to suppress it in terminal output.

Budget Warnings

Set token budget thresholds in your config to get warned when targets consume too much context:

context_budget:
  warn_always_loaded_tokens: 10000
  warn_on_demand_tokens: 100000

When a target exceeds either threshold, sync and analyze display the top 3 offenders by token count. Defaults are 10K always-loaded and 100K on-demand. Set to 0 to disable.

The Web UI Sync page also displays budget violations after each sync.

Bug Fixes

skillshare install now accepts http:// URLs in addition to https:// and SSH protocols (contributed by @eekryuos)

Backward Compatibility

Fully backward compatible. The context_budget config section is optional — omitting it uses sensible defaults. Existing configs require no changes.

Changelog

a54bd20 Fix install command not works with http protocol
b88fb80 chore: update Github
76a242c feat(analyze): show budget warning when thresholds exceeded
a945b3c feat(config): add ContextBudgetConfig for token budget warnings
9510476 feat(server): include context_cost in sync API response
87c355c feat(sync): add context_cost to JSON output
1d29686 feat(sync): add core budget functions with unit tests
8af9a89 feat(sync): add printTokenSummary and printBudgetWarning
cfc7502 feat(sync): wire up token summary and budget warnings in sync CLI
60ed5eb feat(ui): add context budget reference to Config page
786af85 feat(ui): add i18n for context cost section on Sync page
1ea07af feat(ui): display context cost and budget warnings on Sync page
98688ac fix: add context_budget to JSON schema for config validation
9a7271c fix: address PR #151 review feedback
06d2f9f refactor(ui): remove redundant context budget card from ConfigPage
402fe38 refactor: simplify budget warning code after review
f173b1d test(sync): add integration tests for token summary and budget warnings

Notes

Full changelog: https://github.com/runkids/skillshare/blob/main/CHANGELOG.md
Security model docs: https://skillshare.runkids.cc/docs/guides/security
Command reference: https://skillshare.runkids.cc/docs/commands

Contributors

@eekryuos

runkids/skillshare v0.19.9 on GitHub