🛠️ skillshare v0.15.1 Release Notes

Release date: 2026-02-21

TL;DR

v0.15.1 is a patch release with one new feature and several reliability fixes:

Dangling link detection — skillshare audit now catches broken local markdown links in skill files
Push/pull reliability — overhauled init --remote, push, and pull to handle first-sync edge cases
Project init recovery — partial .skillshare/ state is auto-repaired instead of erroring out

What's New

1) Dangling local link detection in audit

skillshare audit now scans .md files for broken relative links — links to files or directories that don't exist:

skillshare audit my-skill

  LOW: broken local link: "docs/setup.md" not found (SKILL.md:42)

Key details:

Severity: LOW — broken links are content quality issues, not security threats
Pattern name: dangling-link
External links (http/https/mailto), anchor-only links (#section), and fragments on valid files are all skipped
Works with --json output and risk scoring like any other finding
Integrated into skillshare install auto-audit (blocked only if threshold is set to LOW)

To disable:

# audit-rules.yaml
rules:
  - id: dangling-link
    enabled: false

Or generate a starter rules file:

skillshare audit --init-rules

Bug Fixes

Push/pull first-sync flow (#35)

The push, pull, and init --remote commands have been overhauled to handle several edge cases reported in #35 — where first-time setup with an empty remote repo failed with confusing upstream tracking errors:

push now auto-sets upstream tracking on first push — no more "has no upstream branch" errors
pull correctly handles empty remotes and sets up branch tracking automatically
Re-running init --remote on an existing config no longer fails
Conflicting remote URLs are detected and reported clearly

Partial project init recovery

If .skillshare/ exists but config.yaml is missing (e.g. interrupted init -p), commands now auto-repair the config instead of failing with "project already initialized."

Documentation

Added missing --reverse and --staged flags to diff command page
Added missing --from flag to restore command page
Aligned cross-machine sync guide with new push/pull behavior
Added per-skill target routing FAQ entry
Added short flag aliases (-s, -c, -t, -d, -n) to built-in init skill reference

Upgrading

# Homebrew
brew upgrade skillshare

# Go install
go install github.com/runkids/skillshare/cmd/skillshare@v0.15.1

# Self-upgrade
skillshare upgrade

Changelog

2b63864 docs(faq): add per-skill target routing FAQ entry
cea26ea feat: add dangling local markdown link detection to audit
8905580 fix: harden pull/push first-sync flow and add regression coverage
6b8c384 fix: overhaul push/pull/init git remote flow
836f1b4 refactor: dedupe git helpers and isolate test state

runkids/skillshare v0.15.1 on GitHub