Version bump
------------
1.22.1 -> 1.23.0 across all workspace packages. Minor bump covers the
slim-install dependency layout, safer first-time agent picker, and the
corresponding doc + branding changes.
Prune dead optional deps in @skillkit/core
------------------------------------------
@anthropic-ai/sdk, @google/genai, ollama, and openai were listed as
optionalDependencies but never imported. They were pulled through
@skillkit/cli transitively on every default install, adding ~57
packages and one deprecation warning (node-domexception via the
SDKs' own formdata-node / node-fetch transitives). Grep of
packages/core/src confirms no SDK import; providers in
src/ai/providers use direct fetch() against the provider HTTP APIs.
Drop them. better-sqlite3, sqlite-vec, and node-llama-cpp stay
because they are actually dynamic-imported by the vector store and
embedding pipeline.
Measured on a fresh npm cache (overrides-pinned file: tarballs):
before: 475 pkgs / 18s / 3 deprecation warnings
1.23.0: 418 pkgs / 18s / 2 deprecation warnings
slim: 118 pkgs / 9s / 0 deprecation warnings
The two remaining warnings are upstream:
- prebuild-install@7.1.3 from better-sqlite3 (must stay)
- glob@9.3.5 from @opentui/solid -> babel-plugin-module-resolver
README rewrite
--------------
Punchier top fold. Palette-consistent SVG tag badges under
assets/tags/ replace most shields.io badges (still keep npm/CI/etc
on shields since they need live data). Collapsible detail blocks
for every feature instead of the linear wall. Same nav anchors the
site uses. No em dashes. No AI filler words. Writing style pulls
from the ai-engineering-from-scratch and awesome-claude-design
READMEs the user already runs.
Branded SVG tags
----------------
scripts/gen-tags.mjs generates 20 SVG pills under assets/tags/ in
the SkillKit palette (#09090b base, #fafafa text, #3f3f46 border,
accent per tag). Two variants: single pill with left accent bar
(new, slim-install, v1.23.0, etc.) and split badge (agents | 45,
packages | 118, install | 9s). Matches the aesthetic used on
awesome-claude-design, tailored to SkillKit's monochrome brand.
The tags directory is fork-and-remix friendly; README points to it.
npx skillkit add <owner/repo> is the most common first-touch path,
so call it out explicitly. Cover:
- Full vs slim invocation (npx skillkit add vs npx --omit=optional
skillkit add), with the same 118/9s slim numbers.
- How the npx cache at ~/.npm/_npx/ makes subsequent runs instant
until a new version ships.
- When to graduate to a global install: skips the prompt-to-proceed
and kills the per-release refetch cost.
Updated in all four install-docs surfaces: root README, apps/skillkit
README (npm landing), docs/fumadocs/content/docs/installation.mdx,
and the Documentation.tsx components used on the website and the
fumadocs mirror.
Two nits from CodeRabbit on the first-user picker:
1. detectAgent() returns 'universal' as a fallback when no concrete
adapter is detected. Passing that through to quickAgentSelect made
the picker show "Just Universal (detected)" even when no real
agent was found — misleading. Treat 'universal' as "not detected"
and fall through to the plain select/all options instead.
2. The "All detected agents" label on the bottom option was wrong:
agents at the call site is getAllAdapters() (all supported
adapters), not only detected ones. Rename to "All supported
agents" and change the hint to "writes to every adapter" so
users aren't tricked into thinking this is a safe detected-only
install.
Devin review caught a hard bug: apps/skillkit/src/index.ts had a
static re-export of startTUI from @skillkit/tui. Now that tui is an
optional dependency, importing the skillkit package would crash with
ERR_MODULE_NOT_FOUND whenever the optional dep was skipped
(--omit=optional). Convert the re-export to an async wrapper that
dynamically imports @skillkit/tui on call. The error is surfaced
naturally with a clear Cannot-find-package message.
Docs updates so users understand the new split:
- README.md: add "Install sizes" section with full vs slim table,
cold-install measurements (475 pkgs / 18 s vs 118 / 9 s),
per-feature package mapping, and how to add a single optional
package later.
- apps/skillkit/README.md (npm landing): add "What's optional"
table + install mode guidance.
- docs/fumadocs/content/docs/installation.mdx: add "Full vs slim
install" section covering all four optional features.
- docs/skillkit/components/Documentation.tsx +
docs/fumadocs/src/components/Documentation.tsx: add "Optional
Features" block to the Quick Start step on the website.
Verified: after `npm install --omit=optional`, `import('skillkit')`
succeeds with 622 exports loaded, and `await startTUI()` fails with
a clean "Cannot find package '@skillkit/tui'" message instead of
crashing at module-load time.
Before: first-time users (no history) saw "All detected agents"
as the first option in the agent picker. Mashing Enter would
install to all 32 agents, writing files across every adapter's
config dir. Selecting "Select specific agents" also pre-ticked
all 32 agents, requiring the user to un-tick by hand.
After:
- Default option is "Just <detected> (detected)" — one agent,
low blast radius.
- "Select specific agents" moves above "All detected agents"
and pre-ticks only the detected agent.
- "All detected agents" gets a second confirm gate
("Install to all N agents?") with initialValue: false.
- Hint text on "All" warns "use only if you know".
Returning users still see "Same as last time (Recommended)" as
the first option; their flow is unchanged.
Non-TTY path is unchanged (still auto-detects a single agent).
Wire detectAgent() through quickAgentSelect so the picker can
label and pre-select the detected agent. Empty selection from
the confirm gate is treated as cancellation.
Move @skillkit/api, @skillkit/tui, @skillkit/mesh, @skillkit/messaging
to optionalDependencies. Drop @skillkit/memory entirely — the CLI
never imported it (only @skillkit/mcp-memory consumes it).
Killing @skillkit/memory removes cozo-node (native Rust) and
@xenova/transformers (~300MB ML stack) from the critical install
path. Making @skillkit/tui optional removes @opentui/core's
prebuild-install toolchain, which was the source of the
inflight/gauge/npmlog/tar/glob deprecation warnings.
Add skipNodeModulesBundle + platform=node + target=node18 to
apps/skillkit tsup config so optional deps stay external.
All TUI/mesh/messaging/api commands already lazy-import via
dynamic import() with surrounding try/catch, so missing optional
deps surface as a graceful error rather than a crash.
Measured impact (npm i skillkit in a clean cache):
Scenario Packages Time Deprecations Vulns (crit/high)
main 544 37s 10 33 (5/5)
slim (default) 475 18s 3 25 (0/0)
slim --omit=optional 118 9s 0 0
Core commands (list, find, translate, recommend, install, --help,
--version) smoke-tested in all three scenarios. Optional commands
(ui, mesh, message, serve) confirmed to degrade with a clean
"Cannot find package" error under --omit=optional.
Add --json flag with structured JSON output to: create, enable, disable,
eval, sync, tap (add/remove/list), translate, save, read.
Add loading spinners to: audit, fix, test, plugin, team, methodology,
hook, remove. Commands that already had spinners get --json-aware no-op
spinners when --json is active to suppress visual output.
- action.yml: pass inputs via env vars, whitelist allowed commands
- All --json commands: use no-op spinner to prevent stdout pollution
- remove: run AGENTS.md update before JSON output (was skipped)
- eval: gate spinner on json format, wrap in try/catch for cleanup
- scan: wrap spinner in try/catch for cleanup on failure
- Resolve symlinks with realpathSync before path containment check
to prevent symlink-based directory escape in skillkit_resource
- Search project-local skills before home-level (cwd first in roots)
- AGENT_DIR_MAP now maps to arrays, includes non-standard global
paths (opencode: .config/opencode/skills, windsurf: .codeium/...)
- Extra global dirs scanned when agent filter matches
Three new tools for token-efficient local skill access:
- skillkit_catalog (L1): lightweight catalog of installed skills (~50 tokens/skill)
- skillkit_load (L2): full SKILL.md content for a single skill
- skillkit_resource (L3): specific reference file with path traversal protection
Bumps server version to 1.21.0. Adds 14 new tests (18 total).
- Fix "44 agents" → "45 agents" across 34 files (website, docs,
package.json, tests, extension, API, TUI)
- README: add tap, check, update, publish submit to commands section
- Commands.tsx: add Sources category with tap commands, update manage
group with remove --source/--all and check
- commands.mdx: full docs for tap, check, update, remove, publish
submit with all new flags and behaviors
- configuration.mdx: document lock.json and taps.json
- security.mdx: document trust badges system
- install: use actual installed path (handles .md files) for lock
entry and results instead of reconstructing from skillName
- update: call addSkillToLock after both local and remote updates
so lock.json stays in sync with metadata
- update: --force bypasses GitHub activity and checksum skip-checks
- update: timestamp comparison falls back to installedAt when
updatedAt is not set
- Use finally for temp cleanup so user cancels don't leak cloned dirs
- Move addSkillToLock outside inner agent loop, merge agents array
- Use source:name as lock key to avoid cross-source collisions
- Gate GitHub activity check on provider.type (skip for GitLab/Bitbucket)
- Normalize source URL to owner/repo before official check
- Include skill name in trust badge output
- Atomic lock.json writes via tmp file + renameSync
- Remove stale --federated suggestion from find no-results message
Introduce tap add/remove/list commands to manage custom skill sources
stored in ~/.skillkit/taps.json. Taps are included in find/search
results, allowing users to add private or community repositories.
Introduce ~/.skillkit/lock.json with LockEntry/LockFile schemas to
track all installed skills in a single file. Install writes entries,
remove deletes them. Enables future team sync and reproducible setups.
Compute SHA-256 checksum of SKILL.md on install and store in metadata.
During update, check GitHub pushedAt timestamp and compare checksums
to skip unnecessary re-downloads when content hasn't changed.
Show trust badges for each skill during install: [Official] for known
official sources (Anthropic, Vercel, Expo, Remotion, Supabase, Stripe),
or [Trusted]/[Review]/[Caution] based on TrustScorer analysis.
- Hoist cloneResult above try block so catch can clean up temp dir
on any failure path, not just the happy path
- Always include GitHub API in find search results (was behind
--federated flag, now default)
- Pass all user-controlled values via env vars instead of
interpolating ${{ outputs.* }} into inline scripts
- Fix operator precedence bug: entry.source || (owner && repo ? ...)
- Use --body-file instead of heredocs with interpolated values
- Quote all variable references in shell commands
Add .github/workflows/auto-publish.yml that triggers on skill-submission
labeled issues, extracts JSON from issue body, validates the source repo
exists, runs security scanner and quality evaluation, then auto-merges
passing submissions (score >= 75) or flags them for manual review.
Add NousResearch/hermes-agent to marketplace/sources.json as a federated
search source for Hermes agent skills.
publish submit:
- Runs quality eval + security scan before submission
- Shows quality badge, stars, last push date, and warnings
- Creates issue directly via gh CLI (no browser needed)
- Falls back to manual URL if gh is not installed/authenticated
- Issue body includes quality score, stars, and push date
check:
- Fetches pushed_at from GitHub API for real update detection
- Shows quality badges next to skill names
- Shows stars and push date in verbose mode
- Displays average quality score across all skills
- findSkill: fall through to .md check when parseSkill returns null
- Use isPathInside instead of dir.includes(cwd) for location detection
- Optional chaining on meta.source in remove --source filter
- Track fence delimiter type per CommonMark (backtick vs tilde)
- Wrap statSync in try-catch so one bad source doesn't abort all installs
- Add cleanup fallback when sparse-checkout/checkout fails
Standalone .md skills (e.g. doc_explanation.md) now get metadata saved
as .doc_explanation.skillkit.json in the same directory. This allows
remove --source to find and remove them. Updated saveSkillMetadata,
loadSkillMetadata, loadMetadata, and remove command to handle both
directory and sibling metadata patterns.
- skillkit remove --all: removes all installed skills
- skillkit remove --source iii-hq/iii: removes all skills from that source
- Both check .skillkit.json metadata to match source
getSearchDirs now collects skill directories from ALL agent adapters
instead of only the configured agent. This fixes 'skill not found' when
skills were installed to .claude/skills/ but the default agent is
universal (which only searches skills/).
findSkill now also checks name.md for standalone .md skills that were
installed as plain files.
Move isStandaloneFile detection and .md suffix normalization before
the existence/force/symlink checks so all code paths use the same
effective target path. Fixes --force not detecting previously installed
standalone skills and symlinks pointing to the wrong filename.
- Restrict try/catch to only the partial clone spawn so
sparse-checkout/checkout failures bubble up as real errors instead
of being misreported as "partial clone unsupported"
- Cap stderr accumulator to 4KB to bound memory on verbose clones
- Add -- terminator before sparsePaths in sparse-checkout set to
prevent user-controlled subpath from being parsed as git options
Instead of wrapping standalone .md skills in a directory, copy them
as-is with .md extension. Skip saveSkillMetadata for standalone files
since it requires a directory. This preserves the original format that
repos like iii-hq/iii use for lightweight single-file skills.
Standalone .md skills (e.g. doc_explanation.md) were copied as plain
files, then saveSkillMetadata tried to write .skillkit.json inside
them causing ENOTDIR. Now detects file sources via statSync and
creates a directory with SKILL.md inside instead.
- spawnGit: set stdout to 'ignore' instead of 'pipe' to prevent
buffer deadlock (git clone writes to stderr, not stdout)
- tryPartialClone: emit fallback message via onProgress instead of
silently swallowing the error
- scanner: preserve fence markers so PI011 delimiter injection is
still detected, only strip inner code block content
- scanner: guard against unclosed frontmatter by looking ahead for
closing --- before entering frontmatter mode
cloneRepo now accepts a subpath option. When set, sparse-checkout
includes both the subpath itself and SKILL_DISCOVERY_PATHS under it.
All four providers pass their parsed subpath through to cloneRepo.
Without this, sparse checkout would skip the subpath directory and
discoverSkills would find nothing.
Strip fenced code blocks and standard YAML frontmatter before scanning
markdown files. This eliminates three categories of false positives:
- PI013: no longer flags standard --- frontmatter delimiters
- CI007: no longer flags curl|sh in code examples
- DE003: no longer flags process.env in code examples
Real threats in prose (outside code blocks) are still caught.
Replace silent execFileSync with async spawn + --progress flag so the
spinner shows real download progress (e.g. "Receiving objects 45%").
For large monorepos, try partial clone (--filter=blob:none) with sparse
checkout of SKILL_DISCOVERY_PATHS first, falling back to regular
--depth 1 clone if the server doesn't support it. Also adds
--single-branch --no-tags to all clones.
Shared cloneRepo() helper in base.ts eliminates duplicate clone logic
across all four git providers.
- selectSkills/selectAgents now return { result, exitCode } to
distinguish errors (exit 1) from cancellations (exit 0)
- Fixes: --skill with nonexistent name returned 0 instead of 1
- Fixes: --agent with invalid name returned 0 instead of 1
- ai.ts: s.stop('msg', 1) → s.stop(colors.error('msg'))
(clack spinner.stop only accepts message, not exit code)
generate.ts and manifest.ts now warn when --agents (deprecated) is
used instead of --agent. Message: "Warning: --agents is deprecated,
use --agent instead (--agents will be removed in v2.0)"
Findings 3 (scan.ts stderr) and 4 (translate.ts stderr) skipped:
error() from onboarding goes to stdout via clack — this is the
standard pattern across all migrated commands. Changing individual
commands would break consistency.
The TUI had a manually-maintained 44-agent AgentType union in
translator.service.ts that fell out of sync when openclaw was added
to core. Replace with re-export from @skillkit/core so it stays in
sync automatically. Fixes CI typecheck failure from #86.
* fix: version display, install UX — audit findings
- Fix version showing hardcoded 1.7.6 instead of actual 1.19.2
- Export setVersion/setAgentCount from @skillkit/cli
- Call setVersion(version) and setAgentCount(getAllAdapters().length) in cli.ts
- Change fallback from '1.7.6' to 'dev' so stale values are obvious
- Fix install pre-selecting all skills by default (bad UX)
- Add "Install all / Select specific" prompt before multiselect
- When selecting manually, start with nothing pre-selected
- Apply same fix to both InstallCommand and runInstallFlow()
- Matches existing quickAgentSelect pattern
Fixes found during comprehensive codebase audit.
Related issues: #87, #88, #89, #90, #91, #92, #93, #94
* refactor: extract quickSkillSelect, use getAdapterCount
- Extract duplicated "Install all / Select specific" pattern into
quickSkillSelect() in prompts.ts (mirrors existing quickAgentSelect)
- Both install.ts and runInstallFlow() now use the shared helper
- Add getAdapterCount() to @skillkit/agents to avoid allocating 44
spread-copied objects just to call .length
- Use getAdapterCount() in cli.ts instead of getAllAdapters().length
* feat: add multi-tier eval engine (skillkit eval)
6-tier evaluation system for comprehensive skill assessment:
- Tier 1: LLM quality scoring (G-Eval pattern, 6 dimensions)
- Tier 2: Contradiction detection (formal rules + LLM semantic)
- Tier 3: Behavioral security (code analysis + taint tracking + LLM)
- Tier 4: Sandbox execution testing (Docker, graceful skip)
- Tier 5: Dynamic marketplace benchmarks (percentile ranking)
- Tier 6: Community signals (freshness, metadata, content health)
Works without API keys (heuristic fallback for Tier 1, Tiers 5-6).
Full LLM evaluation with --provider flag.
* fix: address Devin review — input validation for eval CLI
- --min-score NaN bypass: validate parseInt result before comparison
- --timeout NaN propagation: skip NaN timeout instead of passing to Docker
- --tier invalid input: graceful error message instead of unhandled throw
- scoreContentSize formula: cap sub-optimal at 99 to distinguish from optimal
* fix: address CodeRabbit review findings on eval system
- Harden contradiction/security prompts against prompt injection by
wrapping untrusted content in <skill_content> XML tags and adding
explicit "treat as untrusted data" instructions
- Use head+tail content sampling in security prompt instead of head-only
truncation to catch malicious payloads at end of content
- Add missing Tier 4 sandbox formatter to reporter.ts
- Fix misleading sampleSize fallback in dynamic-benchmark.ts
- Move --min-score NaN validation before engine.evaluate() to avoid
wasting LLM calls on invalid input
- Add truncation indicator to quality-cot.ts prompts
- Add term length limits (>100 chars) in contradiction.ts to mitigate
ReDoS risk on dynamically constructed regex
* fix: address round 2 review findings on eval system
- Wrap quality-cot prompts with <skill_content> XML tags and untrusted
data instructions, consistent with contradiction/security prompts
- Change truncateContent to head+tail sampling (4000+2000) instead of
head-only, so completeness/token-efficiency evaluators see both
beginning and end of long skills
- Fix escapeXmlTags regex to handle whitespace variants before closing
angle bracket (</skill_content >, </skill_content\n>)
- Type DIMENSION_PROMPTS with Record<EvalDimension, PromptBuilder> for
compile-time key validation
- Clamp estimatePercentile return to [0,100] range defensively
- Make buildStatsFromMarketplace async with periodic yields (every 50
skills) to avoid blocking the event loop on first-run cache miss
- Extract parsedTimeout local variable in eval.ts to avoid double
parseInt parsing
* fix: address round 3 Devin + CodeRabbit findings on eval system
- Scan both code blocks AND full content for dangerous patterns in
behavioral-security.ts, with deduplication by description+snippet
to avoid double-reporting (Devin: security scanner skipped prose)
- Use non-greedy regex /\[[\s\S]*?\]/ in parseSemanticFindings to
match first complete JSON array instead of greedily spanning to
last bracket in LLM response (Devin: greedy regex corrupted JSON)
- Fix formatSandboxDetails to use r.testCase matching SandboxResult
type instead of r.name which doesn't exist (Devin: property mismatch)
- Make MarketplaceSkill.description optional to match marketplace
schema where only id/name/source/tags are required (CodeRabbit)
- Rename sandbox test case from "code example execution" to "code
block content validation" since it validates content not execution
(CodeRabbit)
* fix: address round 4 Devin + CodeRabbit findings on eval system
Inline fixes:
- Replace greedy JSON regex in behavioral-security.ts runLLMAnalysis
with balanced bracket extraction that correctly handles ] inside
JSON string values
- Replace non-greedy regex in contradiction.ts parseSemanticFindings
with same balanced bracket extraction (non-greedy also breaks on
inner brackets)
- Fix crossValidatedCount in behavioral-security.ts to accumulate
(+= uniqueEngines.size) instead of replacing (Math.max)
- Fix gradeDeterministic: cleanExit && hasOutput without matching
expectedOutcome now returns passed:false score:50 instead of
passed:true score:75
- Docker unavailable returns score:-1 sentinel instead of 0/F;
engine.ts filters score<0 tiers from overall average so
Docker-less machines aren't penalized
Duplicate fix:
- Add score field to SandboxResult type; store gradeResult.score
in each result; compute tier score from average of numeric scores
instead of boolean pass rate
Nitpick fixes:
- Distinguish "Docker unavailable" from "No tests executed" in
formatSandboxDetails
- Tighten base64 obfuscation regex to require 4-char groups
- Only push 'llm' to engines when LLM actually produced findings
- Bound \s+ to \s{1,10} in dynamically constructed regexes in
contradiction.ts to prevent catastrophic backtracking
- Validate cache timestamp with Number.isFinite() in loadCache to
reject corrupted cache files with NaN timestamps
Ran `npx tessl skill review --optimize` on all methodology pack
skills and find-skills. Key improvements:
- Better descriptions with "Use when..." clauses and concrete verbs
- Lowercase-hyphenated name format for consistency
- Trimmed self-evident prose Claude already understands
- Added executable examples and quick reference tables
- Condensed verbose sections into compact tables/summaries
- Fixed YAML parsing errors (unquoted colons in descriptions)
Net result: -552 lines across 14 files.
* feat: add Context Engineering and Antigravity Awesome Skills sources
Add two major community skill repositories to the marketplace:
- muratcankoylan/Agent-Skills-for-Context-Engineering (12.6K stars):
13 skills on context engineering, cited in Peking University paper
- sickn33/antigravity-awesome-skills (16.8K stars):
954+ agentic skills across 9 categories for Claude Code, Gemini CLI,
Cursor, Copilot and more
Sources: 31 → 33 curated collections
Skills: 15,079 → 15,136 indexed entries
* fix: deduplicate skill IDs and fix slack/notion ID mismatch
- Fix ID mismatch: slack-automation → notion-automation (name/desc were Notion)
- Remove 16 generic duplicate entries that clashed with detailed ones
- Total skills: 15,136 → 15,120 after dedup
* fix(extension): replace server API with local content extraction
Chrome Web Store rejected the extension because the core "Save page as
Skill" feature called https://skillkit.sh/api/save-skill which is
unreachable during review. This rewires page saving to work entirely
locally using chrome.scripting.executeScript to extract page content
(title, meta description, headings, body text) directly in the browser.
- Remove API_URL and callSaveApi() server dependency
- Add extractPageContent() via chrome.scripting.executeScript
- Add detectTags() with weighted keyword scoring (URL/headings/body)
- Add buildPageSkill() to generate SKILL.md with frontmatter locally
- Add scripting permission to manifest
- Pass tabId from popup to background for script injection targeting
- Block chrome-extension:// and chromewebstore.google.com URLs
- Add console.error logging in catch blocks for debuggability
- Guard currentTabId validity in popup click handler
- Update store listing to reflect fully local processing
- Bump version to 1.20.0
* fix(extension): address code review findings for robustness
- Extract RESTRICTED_PREFIXES and isRestricted() into shared constants.ts
so popup and background use the same URL blocklist
- Fix yamlEscape to quote YAML bare scalars (true/false/null/yes/no/on/off)
and numeric strings that parsers would coerce to non-string types
- Apply yamlEscape to skill name fields in both buildPageSkill and
buildSelectionSkill to prevent YAML misinterpretation
- Switch tag detection from substring matching to word-boundary regex
to eliminate false positives (e.g. "js" matching "adjustments")
- Check chrome.runtime.lastError in download callback and always
revoke blob URL to prevent leaks on download failure
* feat: integrate skills.sh as first-class registry
Add SkillsShRegistry and SkillsShProvider so users can install skills
directly from skills.sh (e.g. `skillkit install skills.sh/owner/repo/skill`).
The find command now searches skills.sh by default alongside the local
marketplace. Post-install shows skills.sh popularity stats and pro tips
highlighting skillkit's unique features (translate, recommend, evaluate).
* fix: address CodeRabbit and Devin review findings for skills.sh integration
- Fix path traversal vulnerability in SkillsShProvider.clone (validate subpath containment)
- Fix federated search skipped for interactive queries (use searchTerm instead of this.query)
- Guard showSkillsShStats to skip network call for local providers
- Replace deprecated npm --production with --omit=dev
- Fix loose includes() match in getSkillStats to use strict endsWith()
- Fix FederatedSearch resilience: don't re-throw RateLimitError, return partial results
- Forward timeoutMs through FederatedSearch to registries
- Extract shared formatCount utility to helpers.ts (deduplicate find.ts/install.ts)
- Fix install hint to use skill.source instead of fragile skill.description
- Fix timer leak in fetchLeaderboard using finally block
- Deduplicate URL parsing via shared parseSkillsShParts helper
- Validate --agent flag values against known agent types
* Security hardening and code quality fixes
- Replace execSync with execFileSync to prevent shell injection (providers, executor, fetcher, publish)
- Add security headers: X-Content-Type-Options, X-Frame-Options, Content-Security-Policy, Referrer-Policy
- Add input validation for save route name field to prevent path traversal
- Fix rate limiter IP extraction (x-forwarded-for + x-real-ip fallback)
- Default server bind to 127.0.0.1 instead of 0.0.0.0
- CORS fallback to * (configurable via options.corsOrigin)
- Use execFileSync in publish submit (avoid shell injection when opening browser)
- TLS-aware health checks and HTTPS support in RemoteTransport
- Conditional rejectUnauthorized for TLS (self-signed configurable)
- Add **/.env.local patterns to .gitignore
- Formatting: double quotes, trailing commas (Prettier)
* fix: address CodeRabbit and Devin review findings from PR #74
- TLS: default allowSelfSigned=true to preserve self-signed cert workflow;
enforce rejectUnauthorized=true when trustedCAs are supplied in client context
- Signature verification: verifySecureMessage now cryptographically verifies
signatures using PeerIdentity.verifyHex instead of only checking fingerprints
- WebSocket: fix timeout handle leak in performClientHandshake; add error
logging to empty catch blocks; add per-socket error handler; pre-compute
signature once in broadcast(); add send error callbacks; reject startup if
TLS configured but certInfo missing
- Command parsing: replace broken regex tokenizer with shared splitCommand()
utility that correctly handles --flag="value with spaces"
- Rate limiter: prefer x-real-ip, fall back to rightmost x-forwarded-for entry
- Save route: scope IPv6 prefix checks to actual IPv6 addresses; stop leaking
internal error messages to clients
- Publish: extract shared parseSkillFrontmatter(); fix getRepoInfo to use
async execFileSync; fix path containment checks with separator
- Remote transport: add rejectUnauthorized option; bracket IPv6 in URLs;
fix host:port splitting for IPv6 with lastIndexOf
- Health checks: add tls/tlsAllowSelfSigned to Host type; pass https options
- Fetcher: validate owner/repo; derive indexDir from INDEX_PATH
- .gitignore: add recursive **/.env pattern, remove redundant entries
* fix(executor): restore shell feature support in shellExecutor
The previous security hardening replaced execSync with execFileSync,
which broke commands using pipes, redirects, and subshells. Now detects
shell metacharacters and falls back to sh -c for those commands while
keeping execFileSync for simple commands.
* chore: migrate domain from agenstskills.com to skillkit.sh
Update all OG/Twitter meta tags, API endpoints, docs links, badge
URLs, privacy policy, extension store listing, and README references
to use skillkit.sh. Both skillkit.sh and agenstskills.com are treated
as equal domains — privacy policy, store listing, and docs reference
both.
* perf: skip Vercel builds when docs unchanged
Add ignoreCommand to both docs/skillkit and docs/fumadocs vercel.json.
Vercel will skip rebuilds when the respective docs folder has no
changes, saving ~1h+ of build minutes per billing cycle.
* chore: migrate domain from agenstskills.com to skillkit.sh
Update all OG/Twitter meta tags, API endpoints, docs links, badge
URLs, privacy policy, extension store listing, and README references
to use skillkit.sh. Both skillkit.sh and agenstskills.com are treated
as equal domains — privacy policy, store listing, and docs reference
both.
* perf: skip Vercel builds when docs unchanged
Add ignoreCommand to both docs/skillkit and docs/fumadocs vercel.json.
Vercel will skip rebuilds when the respective docs folder has no
changes, saving ~1h+ of build minutes per billing cycle.
Remove WhySkillKit, StackBuilder, BadgeGenerator, Commands, and
TeamEnterprise sections to streamline the landing page from 14 to 9
sections. Replace Extension nav link with Docs, remove duplicate Docs
link, and add a lightweight docs CTA between AdvancedFeatures and
UseCases.
Wire up 3 new screens from PR #65's session intelligence commands into the TUI with
keyboard navigation (l=timeline, v=lineage, f=handoff) and a new Session sidebar section.
* feat: redesign website with aggregator positioning and competitor landscape
- Add WhySkillKit section with competitor comparison table (Vercel skills, PRPM, Askill, Skild, Paks)
- Show SkillKit as meta-package manager aggregating 31+ sources, not competing with them
- Add source grid showing all curated repositories (Anthropic, Vercel, Expo, Supabase, Stripe, etc.)
- Update Hero tagline: "One CLI. Every Source. Every Agent. Zero Telemetry."
- Fix agent count from 32 to 44 in Features stats
- Reframe comparison table: "Simple Installers" vs "SkillKit" instead of vague "Without"
- Update CompatibilityMatrix with all 44 agents (was 16)
- Add zero-telemetry, Apache 2.0, no-account trust signals
- Update nav to include "Why SkillKit" link
* feat: update terminal demo to showcase aggregator workflow
Show install from multiple sources (Anthropic, Vercel), auto-translation
to 44 formats, security scanning, and cross-source recommendations.
* feat: update promo video with aggregator positioning
Updated Remotion video to reflect SkillKit's meta-package manager identity:
- Version bumped from v1.7.5 to v1.19.0 across all scenes
- Install scene shows multi-source aggregation + security scan
- Find scene searches 31+ sources (15K+ skills)
- Translate scene shows cross-source bulk translation
- Workflow scene replaced with security scanner (46 rules)
- Recommend scene shows cross-source recommendations with source labels
- TUI scene updated with source attribution and 44 agents
- Manifest scene shows multi-source team sync
- Logo scene: "One CLI. Every Source. Every Agent." + "Zero Telemetry"
- Agent count updated from "17 agents" to "44 agents | 31+ sources | 15K+ skills"
* feat: move extension save-skill to server-side API
Chrome Web Store rejected the content script approach since it doesn't
inject on pre-existing tabs. Move webpage-to-skill conversion from
client-side to a server-side API route that uses Turndown + weighted
tag detection, eliminating the need for content scripts entirely.
- Add POST /api/save-skill route with SSRF protection and rate limiting
- Rewrite extension to call API with tab URL instead of injecting scripts
- Remove content script, scripting permission, and turndown dependency
- Add name field validation and YAML-escape source URLs
- Bump extension manifest to v1.18.0
* fix: update privacy policy and store listing for server-side save
Privacy policy previously stated "no external requests" which is now
inaccurate. Updated to clearly disclose that the page URL is sent to
agenstskills.com for processing, what data is NOT sent, and that
nothing is stored server-side.
Store listing updated to match: removed "no server" claims, added
data flow explanation, permissions justifications, and data usage
disclosure section for the Chrome Web Store Privacy tab.
* fix: address Devin and CodeRabbit review findings
- Fix SSRF IPv6 checks blocking legit domains (ffmpeg.org, fdroid.org)
by requiring colon in fc00:/ff prefixes (Devin)
- Add 5MB response body size limit to prevent OOM on large pages,
applied to both extractFromUrl and fetchGitHubContent (CodeRabbit)
- Guard response.json() in callSaveApi against non-JSON error pages
from proxies returning HTML 502/504 (CodeRabbit)
- YAML-escape source URL in buildSelectionSkill to match server-side
handling of URLs with #, :, or query strings (CodeRabbit)