- Add Mesh screen for mesh network management
- Add Message screen for inter-agent messaging
- Update App.tsx with navigation to new screens
- Add 'g' and 'j' keyboard shortcuts for mesh/message
- Update README with mesh and message CLI commands
Fixed getAllAdapters() to return the correct agent type from the
record keys instead of relying on adapter.type property, which
was returning 'universal' for all UniversalAdapter instances.
This fixes the E2E test that checks for all 32 agents in init --list
output (cline, codebuddy, commandcode, etc. were showing as 'universal').
* feat: add skillkit primer command for AI instruction generation
New feature that analyzes codebases and generates AI instruction files
for all 32 supported agents (inspired by pierceboggan/primer).
## New Module: packages/core/src/primer/
- types.ts: Zod schemas and TypeScript interfaces
- analyzer.ts: Codebase analysis (languages, frameworks, conventions)
- generator.ts: Agent-specific instruction file generation
- index.ts: Barrel exports
- __tests__/primer.test.ts: 15 comprehensive tests
## CLI Command: skillkit primer
- --agent/-a: Generate for specific agents
- --all-agents/-A: Generate for all 32 agents
- --output/-o: Custom output directory
- --dry-run/-n: Preview without writing
- --analyze-only: Show analysis only
- --verbose/-v: Detailed output
- --json/-j: JSON output
## Features
- Detects: languages, frameworks, package managers, libraries
- Analyzes: project structure, code conventions, CI/CD, Docker
- Generates: CLAUDE.md, .cursorrules, copilot-instructions.md, etc.
* fix: address CodeRabbit PR review issues for primer
- Fix OS-agnostic path handling in analyzer using path.relative() and path.sep
- Prevent output collisions when multiple agents produce same filename
- Add defensive check in test before accessing generated[0]
- Remove duplicate projectPath parameter in CLI primer command
- Use PackageManager enum instead of z.string() for type safety
- Detect monorepos before src-based layout to prevent misclassification
- Document --output and --json flags in README examples
* fix: additional CodeRabbit review fixes for primer
- Fix Python detection to use correct source file (pyproject.toml, requirements.txt, or setup.py)
- Escape regex special characters in glob pattern matching (e.g., *.module.css)
- Derive ALL_AGENTS from AGENT_CONFIG to avoid divergence
- Map agent config format to template format based on file extension
* feat(primer): support multi-format output rendering
Refactored generateContent to properly respect the format field
instead of always producing Markdown output.
- Added FormatRenderer interface with format-specific implementations
- Created renderers for markdown, mdc, json, xml formats
- JSON format generates structured data via generateJsonContent()
- MDC format includes YAML frontmatter via wrap() method
- XML format properly escapes content with escapeXml()
- Updated all section generators to accept and use the renderer
- Add docs badge and link to README
- Add all new commands: check, find, manifest, fix, audit, publish, status, pause/resume, settings, methodology, plan, plugin, team, hook, command
- Reorganize commands into logical sections
- Update TUI Help screen with new shortcuts
- Add 'd' key to open docs in browser from TUI
- Add noopener to rel="noreferrer" for tabnabbing protection
- Fix standalone skill path handling in readSkillContent and validateSkill
- Derive TOTAL_AGENTS from adapters instead of hardcoded value
- Fix duplicate discovery path for droid/factory agents
- Create dedicated FactoryAdapter instead of using UniversalAdapter
* docs: add comprehensive documentation section to website
- Create Documentation.tsx component with DeepWiki-sourced content
- Add sections: Overview, Installation, Architecture, Agents, Commands
- Add sections: Configuration, API Reference, Skill Format, Tech Stack
- Include interactive sidebar navigation
- Add Docs link to navbar
- Reference DeepWiki as documentation source
Source: https://deepwiki.com/rohitg00/skillkit
* feat(docs): add Fumadocs documentation site and update website
- Add Fumadocs-based documentation site at /docs
- Complete MDX documentation for all features
- TUI section with keyboard navigation
- Installation, quickstart, commands reference
- API reference and configuration guides
- Update SkillKit website (agentskills.com)
- Add 15 new agents (32 total): CodeBuddy, Continue, Crush,
Factory, MCPJam, Mux, Neovate, OpenHands, Pi, Qoder, Qwen,
Vercel, Zencoder, CommandCode
- Update agent count from 17 to 32 across all components
- Update command count from 30+ to 40+
- Remove inline Documentation section (now in Fumadocs)
- Link Docs to /docs route
- Add 15 new agent adapters to @skillkit/agents
- All use UniversalAdapter as base
- Added to detection order and adapter registry
- Configure Vercel rewrites for /docs proxy to Fumadocs
* fix: resolve TypeScript build errors in fumadocs
- Remove createRelativeLink from docs page (not compatible with current fumadocs)
- Remove redundant isLoading prop in SkillGenerator (status already narrowed)
- Fix lucide-react icon type casting in Card component
- Fix MDXComponents return type in mdx-components
* fix: resolve /docs 404 and show docs link on mobile
- Handle undefined slug by defaulting to empty array for index page
- Remove hidden class from Docs link so it shows on mobile
* fix: address CodeRabbit review suggestions
- Move Gemini API key to server-side route (security)
- Add default type='button' to Button component
- Use dynamic agent count instead of hardcoded 32
- Add 'use client' directive to Documentation
- Fix stale closure in SkillSubmitForm with useCallback
- Add URL validation for external references
- Add noopener to external links for security
- Fix Clawdbot path in agents.mdx
- Update cicd.mdx with correct CLI commands
- Capitalize proper nouns (Markdown, provider names)
- Add text language to README code block
- Update date example in quickstart.mdx
* fix: add noopener to external links and improve nav accessibility
- Add noopener to rel attributes on external links for tabnabbing protection
- Add aria-label to nav element for screen readers
- Add type="button" and aria-current to nav buttons
* fix: add vercel.json for fumadocs deployment
* fix: disable turbo detection in Vercel deployment
* fix: clean up ASCII logo for better rendering
* fix: improve code block contrast in SkillGenerator
* fix: sync ASCII logo and code block contrast fixes to old Vite components
* fix: improve mobile responsiveness for tabs and header buttons
* fix: address CodeRabbit security and code quality suggestions
- Add rate limiting to API route (10 requests/min per IP)
- Add proper type validation for topic parameter
- Move API key check after input validation
- Add 'use client' directive to SkillGenerator
- Add YAML escape helper to prevent frontmatter injection
- Change vercel.json to use pnpm instead of npm
- Remove deprecated @types/minimatch dependency (minimatch 10.x has bundled types)
- Fix TUI text rendering overlap by using single text elements instead of multiple
text elements in box rows (Browse, Installed, Marketplace, SkillList screens)
- Fix terminal crash on 'q' press by properly unmounting React tree and restoring
terminal state with escape sequences
- Add signal handlers (SIGINT, SIGTERM) for clean exit
- Bump version to 1.7.6
* feat(cli): add beautiful onboarding UI with @clack/prompts
- Add new onboarding module with theme, logo, prompts, summary, and preferences
- Implement adaptive ASCII logos (full/compact/minimal based on terminal width)
- Add agent icons (⟁ ◫ ◎ ✦ ⬡) and circle-based step indicators (● ○)
- Create agentMultiselect and skillMultiselect with visual formatting
- Add progress bars and score formatting utilities
- Store user preferences in ~/.skillkit/preferences.json
- Update all interactive commands with new UI (init, install, sync, marketplace, recommend)
- Add unit tests (18 tests) and e2e tests (16 tests)
- Replace nested ternaries with if/else for clarity
* fix(cli): address review feedback from CodeRabbit and Devin
- Fix symlink install method: actually create symlinks for subsequent agents
- Fix validate type signature to match @clack/prompts API (string | Error | undefined)
- Handle zero detected agents to avoid empty multiselect blocking
- Clamp divider width to avoid negative repeat counts
- Guard progressBar against invalid totals/values
- Isolate preference tests from real ~/.skillkit state
* fix(cli): TypeScript type compatibility with @clack/prompts
- Cast select options to match Option<T> type signature
- Cast groupMultiselect options for proper Record type
- Fix tasks function return type to Promise<string | void>
* fix(cli): use 'as any' for @clack/prompts type compatibility
The Option<T> type from @clack/prompts has a complex structure that
doesn't match our inline types. Using 'as any' assertion to bypass
strict type checking while maintaining runtime correctness.
* feat: single source of truth for skills marketplace
- Consolidate all skills data to marketplace/skills.json (15,062 skills)
- Add marketplace/sources.json for curated repository sources (31 repos)
- Add skillkit publish command for user skill submissions
- Add auto-publish prompt to skillkit init
- Add AI skill caching with localStorage (7-day TTL)
- Add Submit to Marketplace button for AI-generated skills
- Remove duplicate skills.json files (docs, core)
- Remove legacy src/tui/ folder (replaced by packages/tui)
- Update all imports to use single source files
* fix: address CodeRabbit review feedback
- Remove duplicate checklist items in SkillSubmitForm.tsx
- Add missing sources-schema.json file
- Add slugify method for URL-safe skill IDs
- Fix Windows browser open command (empty title param)
- Fix frontmatter parsing for CRLF and multiline tags
* fix: address additional review feedback
- Add TTY check to skip prompts in CI/non-interactive environments
- Guard against empty slug IDs with validation
- Print full URL in fallback (not truncated)
- Fix repo name parsing for names containing dots
- Add cache pruning and max entries limit (50) for localStorage
* fix: filter empty strings from YAML tags array parsing
- Consolidate all skills data to marketplace/skills.json (15,062 skills)
- Add marketplace/sources.json for curated repository sources (31 repos)
- Add skillkit publish command for user skill submissions
- Add auto-publish prompt to skillkit init
- Add AI skill caching with localStorage (7-day TTL)
- Add Submit to Marketplace button for AI-generated skills
- Remove duplicate skills.json files (docs, core)
- Remove legacy src/tui/ folder (replaced by packages/tui)
- Update all imports to use single source files
* feat(marketplace): add community skill submission system
- Add marketplace/skills.json with curated skills collection
- Add marketplace/schema.json for skill validation
- Add marketplace/CONTRIBUTING.md with submission guidelines
- Add skill submission issue template for community contributions
- Add workflow to auto-process approved skill submissions
- Add bundled skills data in core package for offline access
Community members can now submit skills via GitHub Issues, which are
automatically added to the marketplace when approved by maintainers.
* fix: address CodeRabbit review suggestions for marketplace PR
Workflow improvements:
- Add concurrency block to prevent parallel push conflicts
- Fix authorGithub extraction to preserve hyphens in usernames
- Filter empty tags and validate at least one tag exists
Schema improvements:
- Allow dots in repository names (e.g., user/repo.js)
- Copy schema.json to core package data folder for validation
Documentation:
- Add 'text' language tag to code block in CONTRIBUTING.md
Data sync:
- Add skills.json and schema.json to docs/skillkit/data/
* feat: update agent adapters for 2026 compatibility
- Add new skill-translator module for cross-agent skill translation
- Update Cursor adapter to use .cursor/rules/*.mdc format with YAML frontmatter
- Update Windsurf adapter to use .windsurf/rules/*.md with mode field
- Update GitHub Copilot to use .github/copilot-instructions.md
- Update Trae to use .trae/rules/project_rules.md with YAML frontmatter
- Update OpenCode global path to ~/.config/opencode/
- Add new discovery paths for Cursor, Kilo, Roo, Windsurf, GitHub Copilot
- Improve agent detection with additional config file checks
BREAKING CHANGE: Config file paths have changed for Cursor, Windsurf, Trae, and GitHub Copilot adapters to match their 2026 specifications.
* feat: add e2e tests for skill-translator and fix translation issues
- Add comprehensive e2e tests for skill translator (86 tests)
- Fix translateSkillToAll to include all 17 agents
- Fix writeTranslatedSkill to check for failed translations
- Update vitest config to resolve workspace packages
- Remove unnecessary 2026 comments from agent adapters and skill-translator
* fix: improve agent detection and add overwrite option to translator
Agent detection fixes:
- github-copilot: Remove overly broad .github dir check, only detect
Copilot-specific artifacts (copilot-instructions.md, instructions, ~/.copilot)
- kilo: Fix modes path from .kilocodemodes to .kilocode/modes
- roo: Fix modes path from .roomodes to .roo/modes
Translator improvements:
- Add overwrite option to writeTranslatedSkill() to prevent accidental overwrites
- Return skipped flag when file exists and overwrite=false
Refactoring:
- Centralize agent config in packages/core/src/agent-config.ts
- Update all agent adapters to use shared AGENT_CONFIG
- Re-export utility functions for backwards compatibility
* fix: update clawdbot test and use workspace dependency
- Update clawdbot test to expect new standardized skillsDir (.clawdbot/skills)
- Change @skillkit/core dependency to workspace:* for proper monorepo linking
* fix: address CodeRabbit and Devin review suggestions
- Remove AGENTS.md from detection in Kilo, Roo, Trae adapters (prevents false positives)
- Fix AmpAdapter detection path (check .amp instead of .agents)
- Fix regex pattern in parseConfig for markdown adapters to match any skill name format
- Add hooks and permissionMode to specialFields for proper extraction
- Add path traversal protection in writeTranslatedSkill
- Fix boolean field preservation using 'in' check instead of truthy checks
- Add mode field preservation for Windsurf
- Add permissionMode support for Roo adapter
- Add --recursive flag to scan nested directories for agents
- Add --source flag to specify custom source directory
- New functions: discoverAgentsRecursive, discoverAgentsFromPath
- Add 13 new tests for recursive discovery
- Update README with agent commands documentation
- Bump version to 1.6.3
The fallback sample skills were referencing 'skillkit/samples' which
is a non-existent GitHub repository. Changed to 'built-in' to clearly
indicate these are bundled sample skills.
Fixes#9
* feat: add custom AI sub-agents support (Phase 19)
Add full support for custom AI sub-agents (.claude/agents/*.md):
Core module (packages/core/src/agents/):
- types.ts: Agent types, schemas, AGENT_DISCOVERY_PATHS for 17 AI agents
- parser.ts: Parse agent markdown with YAML frontmatter
- discovery.ts: Discover agents across all supported agent directories
- translator.ts: Translate agents between Claude, Cursor, and universal formats
- index.ts: Export all agent functionality
CLI commands (skillkit agent):
- list: List all installed agents (project + global)
- show: Show agent details
- create: Create a new agent from template
- translate: Translate agents between formats
- sync: Sync agents to target AI coding agent
- validate: Validate agent definitions
Features:
- Agent discovery across 17 AI coding agents
- Frontmatter support: name, description, model, permissionMode,
disallowedTools, allowedTools, hooks, skills, context, tags, author, version
- Translation between claude-agent, cursor-agent, and universal formats
- 36 new tests (706 total passing)
Closes#5
* fix: use workspace:* for internal dependencies
pnpm automatically converts workspace:* to actual versions when publishing,
but uses local workspace packages during development and CI.
* fix: replace require() with ESM imports and add name validation
- parser.ts: Import statSync instead of using require('node:fs')
- translator.ts: Add ESM imports for extractAgentFrontmatter, extractAgentContent, AgentFrontmatter
- agent.ts: Add validation for agent name format (lowercase alphanumeric with hyphens)
Addresses review comments from Devin.
- Add comprehensive E2E test suite (180 tests)
- Fix ESM compatibility, security improvements in test runner
- Align E2E tests with actual CLI interface
- Add timeout guards for reliable test execution
- Add 31 unit tests for ClawdbotAdapter covering all functionality
- Fix Clawdbot detection to check workspace skills/, global .clawdbot/, and clawdbot.json
- Fix escapeXml helper to handle undefined values gracefully
- Update README to document workspace and global skills directories
- Brings total test count to 670 tests (all passing)
* feat: add team collaboration and plugin system
Team Collaboration (Phase 10):
- TeamManager for skill sharing with remote registries
- Skill bundles (create, export, import)
- Team CLI commands: init, share, import, list, sync, remove, bundle-*
- Team TUI screen with navigation key 'a'
Plugin System (Phase 11):
- PluginManager with lifecycle hooks
- Plugin loader (files, npm packages, directories)
- TranslatorPlugin for custom agent formats
- ProviderPlugin for custom skill sources
- CommandPlugin for custom CLI commands
- Plugin CLI commands: list, install, uninstall, enable, disable, info
- Plugins TUI screen with navigation key 'p'
Additional:
- CI/CD command for template generation
- Settings command improvements
- Updated CLAUDE.md with all 11 phases complete
- 359 tests passing
* fix: address PR review comments from Devin
- Fix skill-executor.ts: handle undefined agentToUse when strategy is 'cli'
Previously, if strategy was 'cli' but no CLI agent was available, the
code would fall through and call executeWithAgent with undefined agent,
causing a runtime error.
- Fix cicd.ts: prevent GitLab CI config overwrite without --force
Previously, if .gitlab-ci.yml existed but didn't contain 'skillkit',
it would be overwritten without checking --force. Now it properly
returns early with a helpful message, consistent with CircleCI behavior.
* fix: address PR review comments from CodeRabbit and Devin
Plugin command fixes:
- Fix double-nested .skillkit path when using --global flag
Settings command fixes:
- Add defaultTimeout to help text for available keys
- Wrap const timeout in block scope for switch case
- Fix --set flag validation to require equals sign
Core package fixes:
- Remove .ts from supported plugin extensions (runtime imports fail)
- Store skill name instead of full path in bundle manifest
- Use ESM import for execSync instead of require()
- Replace custom YAML parser with yaml library for proper nested structure handling
TUI screen fixes:
- Guard against empty plugins array in navigation
- Fix empty object pattern in Settings.tsx
- Surface config load failures in Settings screen
- Add manager.load() before sync/import in Team screen
- Guard against empty skills array in Team navigation
- Clamp selection index after skills update
CI/CD command fixes:
- Properly handle skipped workflows (not reported as success)
- Show different final message when nothing was created
- Wrap readFileSync in try/catch for GitLab CI
* fix: address PR review feedback (round 2)
- Security: Add path traversal protection in bundle import
- Fix Plugins.tsx to load plugins from directory before listing
- Fix plugin.ts to persist plugin files to disk on install/uninstall
- Fix Settings.tsx auto-detect vs universal display inconsistency
- Add null check for registry in team/manager.ts sync()
- Thread TeamConfig.auth through provider clone calls
- Fix GitLab CI rules vs only conflict (use rules instead of only)
- Make loadConfig() accept global parameter for --global flag
- Fix relative path detection in plugins/loader.ts (../plugins)
* fix: address PR review feedback (round 3)
- plugin.ts: Add '../' and '~' to isLocalPath detection, use
loader-recognized names (index.js, plugin.json) for single-file copy
- plugin.ts: Remove unused 'basename' import
- settings.ts: Change defaultTimeout validation from < 0 to <= 0
- settings.ts: Use knownKeys whitelist for unknown key detection
- loader.ts: Wrap statSync in try/catch for scanDirectory
- loader.ts: Validate required fields (name, version) before pushing
- loader.ts: Update regex to allow scoped npm names (@scope/name)
- bundle.ts: Resolve targetDir to absolute path for path containment
- Plugins.tsx: Only ignore ENOENT errors, rethrow others
- Plugins.tsx: Load plugins in togglePlugin before enable/disable
* fix: address PR review issues - round 4
CRITICAL fixes:
- loader.ts: Wrap statSync in try/catch in loadPluginsFromDirectory to handle
permission denied and broken symlinks
- bundle.ts: Block path traversal attacks via skill names in importBundle by
validating skill names don't contain / \ or start with .
MAJOR fixes:
- bundle.ts: Use dirname() instead of join('..') for output directory calculation
MINOR fixes:
- plugin.ts: Expand tilde paths (~) before existsSync for proper file operations
- settings.ts: Show defaultTimeout and marketplaceSources in default output
- bundle.ts: Prevent duplicate skill names in bundle with early error
- bundle.ts: Handle single-file skills properly in detectAgents
* fix: address PR review issues - round 5
CRITICAL fixes:
- plugin.ts: Add path traversal protection in uninstallPlugin with name validation
and resolved path checks
- bundle.ts: Fix parseSkillContent to not drop first file when content starts
with "--- file ---" header
MAJOR fixes:
- plugin.ts: Add isValidPluginName() helper and validate plugin.metadata.name
before using in file paths
- plugin.ts: Preserve .mjs extension for single-file ESM plugins
- bundle.ts: Use cross-platform path containment checks with relative() and sep
instead of hardcoded '/'
- loader.ts: Add support for .mjs files (index.mjs, plugin.mjs)
MINOR fixes:
- plugin.ts: Expand tilde (~) path BEFORE calling loadPlugin
- settings.ts: Use null instead of undefined in JSON output for --get so key
is preserved
* fix: allow scoped npm names in isValidPluginName
Update isValidPluginName to allow scoped npm package names like @scope/name
while still preventing path traversal attacks. Uses the same regex pattern
as loader.ts validatePlugin for consistency.
Valid names: my-plugin, @scope/plugin-name
Invalid names: ../evil, .hidden, name\\path, @../evil/name
* fix: handle more relative path patterns in loadPlugin
- Use isAbsolute() for cross-platform absolute path detection
- Add check for paths containing '/' (excluding @scope packages)
- Simplify pattern to source.startsWith('.') for all dot-prefixed paths
- Now correctly handles: plugins/x.js, ../foo, ./bar, .hidden
- Main README now leads with "One CLI. 17 AI Agents. Zero Lock-in."
- Clear problem/solution format showing SkillKit's value
- Feature comparison table (with vs without SkillKit)
- Organized command reference by category
- Updated all package READMEs with comprehensive docs:
- @skillkit/core: Full API examples for all features
- @skillkit/cli: Complete command reference
- @skillkit/tui: Screen descriptions and keyboard shortcuts
- @skillkit/agents: Agent adapter documentation
Security fixes:
- Remove shell: true from spawn to prevent shell injection (agents.ts)
- Add safe regex test with ReDoS protection (engine.ts)
- Add security warning for verification commands (engine.ts)
Bug fixes:
- Fix global memory index path to use ~/.skillkit/ (compressor.ts, memory-index.ts)
- Add task_complete events and verification to resumeExecution (engine.ts)
- Handle absolute URLs in skill entries (aggregator.ts)
- Implement actual port availability check (runner.ts)
- Remove invalid JUnit report format (templates.ts)
- Add crash guard to workflow list command (workflow/list.ts)
- Fix resume skipping checkpoint handling in engine.ts
- Add paused status guard before completeExecution call
- Fix NaN% progress when totalSteps=0 in Execute.tsx
- Fix effectiveness ?? instead of || to preserve 0% values in compressor.ts
- Clear cache on source change in aggregator.ts addSource/removeSource