mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-19 02:13:58 +00:00
docs/website-documentation
10
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
a0b4ee77b4 |
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
|
||
|
|
235130c6ae |
fix(tui): fix rendering overlap and terminal crash on quit (#18)
- 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 |
||
|
|
a5efe29a6c |
feat(cli): add beautiful onboarding UI with @clack/prompts (#17)
* 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. |
||
|
|
0210556634 |
feat(tui): migrate to OpenTUI with monochromatic design (#11)
* feat(tui): migrate to OpenTUI with monochromatic design ## Summary - Migrate TUI from Ink to OpenTUI framework (requires Bun >=1.2.0) - Implement monochromatic B&W design with colored accents - Add Help screen accessible via `/` key - Fix terminal cleanup on exit (no more escape code garbage) - Clean up code: remove unnecessary comments, simplify components - Add 9 unit tests for TUI state, theme, and utilities ## Breaking Changes - TUI now requires Bun runtime (>=1.2.0) for OpenTUI - Help moved from `?` (requires Shift) to `/` key ## Changes - **index.tsx**: Clean exit handler with ANSI terminal restore - **App.tsx**: Simplified screen routing with switch statement - **Help.tsx**: New help screen with keyboard shortcuts reference - **Home.tsx**: Extract FEATURES constant, simplified agent width logic - **Sidebar.tsx**: Removed unused onNavigate prop usage - **state/types.ts**: Consolidated type definitions, added help screen - **README.md**: Updated with Bun requirement and new architecture ## Test Coverage - 757 tests passing (664 core + 80 agents + 9 tui + 1 cli + 3 app) ## Code Quality - Removed all JSDoc comments describing obvious code - Extracted reusable ShortcutSection component - Replaced nested ternaries with clearer if/else - Moved static data outside components to prevent recreation * fix: address CodeRabbit review issues - AgentGrid: prevent infinite loop when columns <= 0 - Splash: clamp progress width to prevent negative repeat - StatsCard: reset animation state when items change - Help: clamp contentWidth to minimum 1 - Browse: add useKeyboard handler for navigation and search - Installed: add useKeyboard handler for toggle functionality - Marketplace: add useKeyboard handler and clamp contentWidth - Recommend: fix spinner interval, add keyboard handler - Settings: add keyboard handler, fix SETTINGS -> settings state - Sync: add keyboard handler and sync flow implementation - Workflow: add keyboard handler and clamp contentWidth - skills.ts: add path validation to prevent directory traversal * fix: address additional CodeRabbit review issues Splash.tsx: - Change generateParticles from useMemo to useCallback for fresh random rows Browse.tsx: - Clamp maxLen to avoid negative slicing - Add Enter/Return handler to open selected repo Installed.tsx: - Wire up 'd' key to toggle handler - Update shortcuts label from "delete" to "disable" Marketplace.tsx: - Add handleInstall callback for Enter key - Add 'b' key handler to navigate to browse Recommend.tsx: - Add handleInstall callback for Enter key Settings.tsx: - Update shortcuts label from "enter edit" to "enter toggle" Sync.tsx: - Add useRef for timeout cleanup on unmount - Clamp selectedIndex when agents list shrinks Workflow.tsx: - Remove unimplemented shortcuts from display string * fix: address performance and stale closure issues Splash.tsx: - Cache getVersion() with useMemo to avoid repeated sync file I/O Installed.tsx: - Wrap keyboard handler in useCallback to prevent stale closures Settings.tsx: - Wrap keyboard handler in useCallback with proper dependencies Workflow.tsx: - Remove "Press 'n' to create one" text since 'n' key isn't implemented |
||
|
|
413519d486 |
feat: update agent adapters for 2026 compatibility (#10)
* 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 |
||
|
|
821fd1b495 |
feat: add custom AI sub-agents support (Phase 19) (#8)
* 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. |
||
|
|
d8a6b4a700 | fix: replace workspace dependencies with actual versions for npm package display | ||
|
|
1344d65b3d |
feat: implement phases 12-18 - complete agentic development platform (#6)
* feat: implement phases 12-18 - complete agentic development platform This comprehensive update implements 7 major phases (12-18) transforming SkillKit into a universal agentic development platform with methodology packs, hooks, orchestration, planning, and AI capabilities. Phase 12: Methodology Framework - MethodologyManager for pack-based methodology distribution - 5 methodology packs (testing, debugging, planning, collaboration, meta) - 13 curated methodology skills - Pack loader with validation and installation - 56 comprehensive tests Phase 13: Hooks & Automatic Triggering System - HookManager with event-driven skill activation - 10+ event types (session:start, file:open, task:start, etc.) - Pattern-based triggers with glob support - Agent-specific hook generation - 29 comprehensive tests Phase 14: Subagent Orchestration - TeamOrchestrator for multi-agent coordination - TaskManager with cross-agent assignment - Plan approval workflow (submit → approve/reject) - TeamMessageBus for agent communication - Two-stage review system (spec compliance + code quality) - 36 comprehensive tests Phase 15: Structured Plan System - PlanParser for markdown → structured plan conversion - PlanValidator for completeness checking - PlanExecutor with dry-run support - Bite-sized task format (2-5 min atomic tasks) - 36 comprehensive tests Phase 16: Slash Commands & Agent Integration - CommandRegistry for slash command management - Agent-specific command generation (Claude, Cursor, OpenCode) - Command aliases and arguments support - 42 comprehensive tests Phase 17: Enhanced Agent Features - Permission system (allow/deny/ask patterns) - Glob pattern matching for file-scoped skills - Bootstrap files (AGENTS.md, SOUL.md, TOOLS.md) - Multi-mode support (Code/Architect/Debug/Ask) - Agent feature tests Phase 18: Advanced Features (AI & Audit) - AIManager with natural language skill search - Automatic skill generation from examples/code - MockAIProvider for testing without API keys - AuditLogger with complete operation trail - Query, export (JSON/CSV/text), and statistics - 37 comprehensive tests (15 AI + 22 audit) CLI Commands Added: - skillkit methodology list|install|sync - skillkit hook add|remove|list|generate - skillkit plan parse|validate|execute|create - skillkit commands generate|list - skillkit ai search|generate|similar - skillkit audit log|export|stats|clear TUI Enhancements: - Methodology screen (o key) for pack browsing - Plan screen (n key) for plan viewing/execution - Updated navigation and sidebar Test Coverage: - Total: 619 tests passing (582 core + 49 agents + 1 cli + 3 app) - New: 245+ tests for phases 12-18 - Coverage maintained at 80%+ Breaking Changes: None Dependencies: No new external dependencies added * fix: apply CodeRabbit security and quality improvements Security Fixes: - Replace custom glob-to-regex with minimatch to prevent ReDoS vulnerabilities - Fix regex pattern generation in globs.ts using battle-tested library - Eliminate unsafe regex patterns in modes.ts and permissions.ts Code Quality Improvements: - Use shared GlobMatcher utility to eliminate code duplication in modes.ts - Preserve command metadata on updates to prevent data loss - Fix single-file vs directory output path handling in command.ts - Pass --strict flag through to plan validator Race Condition & Concurrency Fixes: - Add Promise-based mutex to prevent race condition in audit logger flush() - Handle both sync and async event listeners to prevent unhandled rejections - Maintain synchronous event emission while safely handling async listeners Data Integrity Fixes: - Fix dependency checking to detect missing dependencies - Rehydrate Date fields when importing tasks from JSON - Fix executePlan to properly detect incomplete tasks State Management: - Add validation for missing step executor (fail fast) - Handle cancellation and reset executor state in finally block - Add 'cancelled' status and event to PlanStatus/PlanEvent types Dependencies: - Add minimatch@^10.0.1 to @skillkit/agents package All 639 tests passing. * docs: update READMEs with Phase 10-18 features - Root README: add minimal "What's New in v1.5.0" section with 5 bullet points - packages/core: add usage examples for Team, Plugin, Methodology, Orchestration, Plan, Hooks - packages/cli: add command sections for team, plugin, methodology, plan, hook, command - packages/tui: add screen descriptions for Marketplace, Workflow, Execute, Team, Plugins, Methodology, Plan, Memory - apps/skillkit: expand with practical usage examples for all new features All updates are clean, user-focused, and avoid AI marketing fluff. * fix: resolve multiple code quality and robustness issues - Fix minimatch dependency: downgrade to ^9.0.0 for Node 18 compatibility - Fix command.ts export: handle directory paths and ensure parent directories exist - Fix command.ts merge: preserve curated examples when merging commands - Fix plan.ts: filter empty entries from comma-separated inputs - Fix audit logger pagination: respect explicit 0 for limit and offset - Fix audit logger: gracefully handle malformed JSON lines without data loss - Fix team orchestrator: prevent task assignment to non-idle agents - Fix plan executor: unblock waitIfPaused() when cancel() is called All 639 tests passing. * fix: additional robustness improvements for plan and executor - Fix plan.ts createPlan: filter empty strings from techStack after split/trim - Fix executor.ts: re-check abort signal after waitIfPaused() in both execute() and executeTask() to prevent running additional tasks/steps after cancellation during pause All 639 tests passing. |
||
|
|
d3ffb79512 |
feat: add session memory system for cross-agent learning (#3)
* feat: add session memory system for cross-agent learning
Implements a lightweight, local-first memory system that works across
all 17 AI coding agents. Key features:
- YAML-based storage (no databases or external services)
- Three memory layers: Session, Project, and Global
- AI-powered compression of observations into learnings
- Cross-agent memory injection with relevance matching
- Progressive disclosure for token efficiency
Core modules:
- ObservationStore: Capture raw session observations
- LearningStore: Persist compressed learnings
- MemoryCompressor: AI/rule-based compression engine
- MemoryInjector: Context-aware memory retrieval
- MemoryObserver: Automatic observation capture
CLI commands (skillkit memory):
- status, search, list, show, compress, export
- import, clear, add, rate, config
TUI integration:
- New Memory screen with tabs (Learnings/Observations/Search)
- useMemory hook for state management
- Updated navigation and keybindings
Code quality improvements:
- Replaced nested ternaries with explicit functions
- Added named constants for magic numbers
- Simplified navigation with lookup map
* feat: add marketplace, testing, CI/CD, workflows, and fix dry-run bug
New Features:
- Skill Marketplace: Aggregates skills from GitHub repos with caching
- Skill Testing Framework: 18+ assertion types for skill validation
- CI/CD Integration: Templates for GitHub Actions, GitLab CI, CircleCI
- Workflow Orchestration: Wave-based parallel skill execution
- Session Management: Pause/resume support with state persistence
- Agent Execution: CLI spawning for claude/codex/gemini/opencode/goose
New CLI Commands:
- skillkit marketplace - Browse and install from marketplace
- skillkit test - Run skill tests with assertions
- skillkit run - Execute skills with orchestration
- skillkit status - Show session state
- skillkit pause/resume - Session management
- skillkit workflow - Workflow management
New TUI Screens:
- Marketplace browser with search
- History viewer with session details
- Workflow management screen
Bug Fix:
- Fixed dry-run mode in memory compress command (Devin review)
The --dry-run flag now properly prevents storing learnings
* fix: add missing yaml dependency to @skillkit/cli
* chore: update pnpm-lock.yaml
* fix: address 7 bugs identified by Devin code review
- Fix MemoryIndexStore ignoring isGlobal flag (memory-index.ts)
- Fix ESM runtime crash using require('yaml') in test runner (runner.ts)
- Fix ESM runtime crash using require('node:fs') in MarketplaceAggregator (aggregator.ts)
- Fix ESM runtime crash using require('node:fs') in SessionManager (manager.ts)
- Fix memory rate command parsing rating from --content instead of positional arg (memory.ts)
- Fix SkillExecutionEngine emitting failed status for paused executions (engine.ts)
- Fix run command misclassifying directories as skill markdown files (run.ts)
* fix: address CodeRabbit/Devin review issues (batch 2)
- 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
* fix: address critical and major CodeRabbit/Devin issues (batch 3)
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: address remaining CodeRabbit/Devin issues (batch 4)
- ReDoS protection: Add pattern validator to reject dangerous regex patterns
(nested quantifiers, overlapping alternations, excessive quantifiers)
- Add missing 'cancelled' status message in execution engine
- Make completedAt/durationMs optional in TaskExecutionResult
- Fix tag filter to skip untagged tests when tags are specified
- Improve error-solution matching: require keyword similarity + solution indicator
- Validate --limit and sanitize --tags in memory/marketplace CLI commands
- Guard against missing arrays when importing YAML learnings
- Escape YAML frontmatter values to prevent invalid output
- Preserve original learning source when merging learnings
- Fix keyword double-counting in memory index search
- Normalize keywords by stripping punctuation for better matching
|
||
|
|
160d2b1534 |
feat: add TUI enhancements and monorepo structure (#2)
* feat: add TUI enhancements and monorepo structure - Add Translate screen for cross-agent skill translation - Add Context screen for project context management - Add Recommend screen with smart skill recommendations - Fix TUI screen duplication by using fixed height container - Clean up unnecessary comments following code-simplifier principles - Refactor to monorepo structure with @skillkit/core, @skillkit/cli, @skillkit/tui, and @skillkit/agents packages - Add comprehensive tests for translator, context, and recommend features - Update license to Apache-2.0 - Add CONTRIBUTING.md with contribution guidelines * ci: switch from npm to pnpm for monorepo support * ci: use pnpm version from package.json * fix: remove unused import in TUI helpers |