Commit Graph
14 Commits
Author SHA1 Message Date
Rohit Ghumare 822bd6f753 feat: add security scanner for detecting malicious patterns in skills
Add `skillkit scan <path>` command with 46+ detection rules across 6 threat
categories: prompt injection, command injection, data exfiltration, tool abuse,
hardcoded secrets, and unicode steganography.

- 3 analyzers: static pattern matching, SKILL.md manifest validation, secrets detection
- 4 output formats: summary (colored terminal), json, table, sarif (GitHub Code Scanning)
- Auto-scan on `skillkit install` (--no-scan to skip, --force to override)
- Auto-scan on `skillkit publish` (blocks on HIGH+ findings)
- Threat taxonomy with 10 categories and severity levels
- False-positive filtering for placeholders, test files, safe patterns
- Updated README, CLI docs, website commands, features, and fumadocs
2026-02-08 11:32:31 +00:00
Rohit Ghumare f7803183bf chore: release v1.14.0
Features:
- Smart Context Generation: AI-powered skill generation with multi-source context
  - Multi-provider LLM support (Claude, GPT-4, Gemini, Ollama, OpenRouter)
  - 4 context sources: docs, codebase, marketplace skills, memory
  - Agent-specific optimization for 32 agents
  - Trust scoring and compatibility matrix
  - Skill composition via natural language search

Documentation:
- Added Generate Command section to CLI reference
- Updated README with AI skill generation feature
- Updated website with AI Generate in Advanced Features
2026-02-05 15:43:33 +00:00
Rohit Ghumare 6d290171b7 feat(memory): add lifecycle hooks, progressive disclosure, and auto-compress memory (#44)
* feat(memory): add lifecycle hooks, progressive disclosure, and auto-CLAUDE.md updates

- Add Claude Code lifecycle hooks (SessionStart, PostToolUse, SessionEnd)
  for automatic memory capture and injection
- Implement 3-layer progressive disclosure for token-optimized retrieval
  (Index ~50 tokens, Timeline ~200 tokens, Details ~600 tokens)
- Add CLAUDE.md auto-updater to populate LEARNED section with learnings
- Add auto-compression threshold trigger in observation store
- Add new CLI commands: `memory sync-claude` and `memory index`
- Update documentation with new memory features
- Remove 139 lines of unnecessary inline comments (code cleanup)

* fix(memory): address Devin review comments

- Fix double execution bug in MemoryHookManager by adding
  generateHookOutputFromResult methods to avoid calling execute() twice
- Add setConfig method to PostToolUseHook for runtime config updates
- Update manager.setConfig() to propagate config to all hooks

* fix(memory): address CodeRabbit review comments

- Fix cross-platform path handling using path.basename() instead of split('/')
  in claude-md-updater.ts, session-start.ts, and session-end.ts
- Fix onSessionEnd to call execute() before generateHookOutput to run
  compression/cleanup side effects
- Add generateHookOutputFromResult() to SessionEndHook to avoid double execution
- Call clearOldPendingErrors() in PostToolUseHook.execute() to prevent
  unbounded pendingErrors map growth
- Handle async checkAutoCompression() errors in observation-store.ts
- Add validation for compression threshold (must be positive integer)
- Fix docs/commands.mdx to use correct CLI flags (--limit, --tags)
- Clarify token accounting in progressive-disclosure smartRetrieve() JSDoc
- Use config.minRelevanceForCapture in session-start.ts instead of hardcoded value

* fix(memory): address additional CodeRabbit review comments

- Use nullish coalescing (??) for maxResults defaults in progressive-disclosure
- Guard against non-positive tokenBudget in smartRetrieve()
- Thread minRelevance option through to findRelevantIds()
- Fix memory index CLI to validate --limit and pass maxResults to getIndex()
2026-02-05 11:26:31 +00:00
Rohit Ghumare 1ee5258447 docs: rewrite with clean, concise style (#43)
* docs: rewrite documentation with clean, concise style

Rewrote all core docs pages (index, installation, quickstart, rest-api,
mcp-server, python-client) with problem/solution framing, progressive
code examples, and conversational tone. Updated OpenAPI descriptions
and api.html meta tags to match. 366 additions vs 722 deletions.

* docs(mcp): remove stale skill count, add list_categories tool name

Replace hard-coded "15,000+" with non-specific wording and explicitly
name the list_categories tool in the Browse categories section.
2026-02-04 11:01:48 +00:00
Rohit Ghumare 988a49f38f feat(api): add interactive Swagger UI docs at /docs
- Add OpenAPI 3.1 spec with all endpoints, schemas, and tags
- Serve Swagger UI at GET /docs with try-it-out enabled
- Serve OpenAPI JSON at GET /openapi.json
- Add API info endpoint at GET / with endpoint listing
- Update serve command to show /docs and /openapi.json endpoints
- Update REST API docs page with interactive docs section
2026-02-04 00:46:03 +00:00
Rohit Ghumare 19694dcaa1 docs: add v1.12.0 runtime skill discovery documentation
- README: add Runtime Discovery, serve command, REST API, MCP, Python
  client sections with examples and comparison table update
- Website Hero: update terminal animation with serve/API demo
- Website Features: add REST & MCP APIs card, API Access comparison row
- Website Commands: add Server tab with serve command options
- Fumadocs: create rest-api.mdx, mcp-server.mdx, python-client.mdx
- Fumadocs: update index (v1.12.0, architecture, discovery section),
  commands (serve command), and meta.json navigation
2026-02-04 00:40:49 +00:00
Rohit Ghumare de4425f440 chore: release v1.9.0 (#38)
Features:
- Hierarchical skill tree with 12 categories (skillkit tree)
- LLM-based reasoning engine for skill discovery
- Explainable recommendations (--explain, --reasoning flags)
- Connector placeholders for tool-agnostic skills (~~CRM, ~~chat, etc.)
- Execution flow tracking with metrics
- Standalone vs Enhanced mode detection

CLI:
- New `tree` command for taxonomy navigation
- Enhanced `recommend` with explanation support
- Fixed --skill alias and agent detection

Documentation:
- Added tree.mdx for Skill Tree documentation
- Updated recommendations.mdx with reasoning features
- Updated TUI docs with tree view mode
- Updated README with new features
- Updated website Features and Commands
2026-02-02 16:48:43 +00:00
Rohit Ghumare 8496e3c63c feat(publish): add RFC 8615 well-known skills support (#36)
* feat(agents): add skill-to-subagent converter command

Add `skillkit agent from-skill` command to convert SkillKit skills into
Claude Code native subagent format (.md files in .claude/agents/).

Features:
- Reference mode (default): generates subagent with `skills: [skill-name]`
- Inline mode (--inline): embeds full skill content in system prompt
- Options: --model, --permission, --global, --output, --dry-run

New files:
- packages/core/src/agents/skill-converter.ts
- packages/core/src/agents/__tests__/skill-converter.test.ts (23 tests)

Closes #22

* feat(publish): add RFC 8615 well-known skills support

Redesign publish workflow to align with industry standard:

- Add WellKnownProvider for auto-discovery from any domain
- skillkit add https://example.com discovers skills via /.well-known/skills/
- skillkit publish generates well-known hosting structure
- skillkit publish submit opens GitHub issue (legacy workflow)

Provider discovers skills from:
- /.well-known/skills/index.json (manifest)
- /.well-known/skills/{skill-name}/SKILL.md (skill files)

Includes 16 tests for WellKnownProvider and structure generation.

* fix(wellknown): correct baseSkillsUrl calculation for skills.json fallback

When using the /.well-known/skills.json fallback URL, the previous
logic produced a malformed URL with duplicated .well-known path segment:
- Before: https://example.com/.well-known/.well-known/skills
- After: https://example.com/.well-known/skills

Extract calculateBaseSkillsUrl helper function for better testability
and add 4 new unit tests covering both URL formats.

* docs: update publish command documentation for well-known skills

- README.md: Add self-hosting section with well-known URI structure
- commands.mdx: Add Publishing Commands section
- marketplace.mdx: Expand publish section with self-hosting instructions
- skills.mdx: Add self-hosting workflow documentation

Documents the new `skillkit publish` workflow that generates RFC 8615
well-known URI structures for decentralized skill hosting.

* fix(security): address path traversal and CRLF vulnerabilities

- agent.ts: Sanitize skill.name when building default filename
- publish.ts: Add sanitizeSkillName() to validate skill names before
  using in file paths, verify resolved paths stay within target dir
- skill-converter.ts: Normalize CRLF to LF before extracting body
  content to handle Windows-style line endings
- wellknown.ts: Add sanitizeSkillName() to validate remote skill names,
  verify resolved paths stay within temp dir, encode URL components

* fix(agents): improve YAML string escaping logic

Only escape strings that actually need it for valid YAML parsing:
- Strings containing newlines or colons
- Strings starting with special YAML characters (-, *, &, !, {, [, >, |, @, `)
- Strings starting with quotes

This fixes unnecessary escaping of strings like "code-quality" where
hyphens in the middle don't need escaping.

* fix(wellknown): address security review feedback

- Use path.sep instead of hardcoded '/' for cross-platform compatibility
- Add sanitization and path containment check in generateWellKnownStructure
- Remove unused 'vi' import in wellknown.test.ts
2026-02-01 21:38:42 +00:00
Rohit Ghumare 34e8cd0b61 docs(tui): update documentation for Solid.js migration (#33)
Update TUI documentation to reflect the v1.8.0 migration from React to
Solid.js:

- Change @opentui/react to @opentui/solid
- Change React 19.0.0 to Solid.js 1.9.0
- Add note about migration rationale (performance, bundle size)
- Update performance optimizations section with Solid.js primitives
  (createMemo, createSignal, createEffect)
- Add windowed list rendering mention
- Update Integration section with Solid.js code example
- Update graceful exit to reference onCleanup instead of React unmount
2026-02-01 17:55:45 +00:00
Rohit Ghumare eae5accf36 feat(docs): comprehensive documentation and website improvements (#30)
* feat(docs): comprehensive documentation and website improvements

Website improvements:
- Add AdvancedFeatures component for Memory, Primer, Mesh, Messaging
- Add UseCases component with real-world scenarios
- Add TeamEnterprise component for collaboration features
- Update Hero section with better value proposition
- Make all components mobile responsive
- Pre-populate StackBuilder with default skills
- Add ARIA attributes for accessibility
- Add prefers-reduced-motion for smooth scrolling

Documentation updates:
- Create primer.mdx for auto-generate instructions feature
- Create teams.mdx for team collaboration documentation
- Enhance index.mdx with comprehensive feature overview
- Update quickstart.mdx with advanced features section
- Expand api-reference.mdx with Mesh, Messaging, Workflow APIs
- Update configuration.mdx with Memory, Mesh, Primer settings
- Simplify fumadocs homepage for cleaner presentation
- Fix markdown formatting issues

* fix: address CodeRabbit review suggestions

- Add missing fs import to api-reference.mdx code examples
- Clarify that host comes from MeshHost in messaging example
- Remove broken /docs/registries link from teams.mdx
- Fix ARIA tab/panel linkage in AdvancedFeatures.tsx
2026-01-30 22:21:04 +00:00
Rohit Ghumare e41b0cd8a3 Revert "feat(docs): comprehensive documentation and website improvements (#28)" (#29)
This reverts commit 21df323134.
2026-01-30 21:42:18 +00:00
Rohit Ghumare 21df323134 feat(docs): comprehensive documentation and website improvements (#28)
* feat(docs): comprehensive documentation and website improvements

Website improvements:
- Add AdvancedFeatures component for Memory, Primer, Mesh, Messaging
- Add UseCases component with real-world scenarios
- Add TeamEnterprise component for collaboration features
- Update Hero section with better value proposition
- Update Features section with improved presentation
- Make all components mobile responsive
- Pre-populate StackBuilder with default skills
- Hide Apache 2.0 on mobile, show Docs link on mobile

Documentation updates:
- Create primer.mdx for auto-generate instructions feature
- Create teams.mdx for team collaboration documentation
- Enhance index.mdx with comprehensive feature overview
- Update quickstart.mdx with advanced features section
- Expand api-reference.mdx with Mesh, Messaging, Workflow APIs
- Update configuration.mdx with Memory, Mesh, Primer settings
- Simplify fumadocs homepage for cleaner presentation

* fix: address code review feedback

- Fix markdown heading/list separation in index.mdx
- Fix mesh.security schema in configuration.mdx profiles
- Add shebang to git hook script in primer.mdx
- Update Primer description for multi-agent support in Features.tsx
- Add prefers-reduced-motion media query for accessibility in styles.css
- Add ARIA attributes (role, aria-selected, aria-controls) to AdvancedFeatures tabs
2026-01-30 21:41:33 +00:00
Rohit Ghumare d0b5151683 docs: update for v1.8.0 with npx usage, mesh, and messaging 2026-01-30 18:04:33 +00:00
Rohit Ghumare d1fcf0355f docs: add comprehensive documentation section to website (#23)
* 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
2026-01-28 18:29:14 +00:00