Compare commits

...
Author SHA1 Message Date
Rohit Ghumare 67f0410e1c 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.
2026-02-22 21:37:01 +05:30
Rohit Ghumare 067d2ad3ac 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
2026-02-22 21:37:01 +05:30
Rohit Ghumare d9db9181bb 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)
2026-02-22 21:37:01 +05:30
Rohit Ghumare 39b94534ec chore: release v1.19.2 2026-02-20 00:16:28 +05:30
Rohit Ghumare aeb2b05f15 fix: update composioHQ repo name from awesome-claude-code-skills to awesome-claude-skills (#73)
Closes #72
2026-02-17 19:28:39 +00:00
Rohit Ghumare 5991fead9b fix: compact Features grid — 3 cols mobile, 4 cols desktop 2026-02-14 16:08:19 +05:30
Rohit Ghumare 1d3a779c2e fix: show Docs link on mobile nav (#71)
* 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.
2026-02-14 10:31:26 +00:00
Rohit Ghumare 2fe4702bd6 chore: migrate domain to skillkit.sh (#70)
* 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.
2026-02-14 10:24:08 +00:00
Rohit Ghumare 28ed83deb0 chore: release v1.19.1 2026-02-14 14:24:41 +05:30
Rohit Ghumare 7c4ee9cfef refactor: simplify homepage by removing 5 sections and adding docs CTA (#69)
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.
2026-02-14 07:50:00 +00:00
Rohit Ghumare 64cafc76a1 feat: add TUI screens for session intelligence (timeline, lineage, handoff) (#68)
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.
2026-02-14 07:33:01 +00:00
Rohit Ghumare 7e3b31b43b feat: add session intelligence — timeline, handoff, and lineage (#65)
* feat: add session intelligence — timeline, handoff, and lineage commands

Three new skill-centric session intelligence features:
- `skillkit timeline` — unified chronological event stream merging skill executions, git commits, observations, decisions, and snapshots
- `skillkit session handoff` — generates structured markdown for agent-to-agent context transfer with accomplished/pending tasks, key files, observations, and recommendations
- `skillkit lineage` — tracks skill impact graph connecting skills to files, commits, and observations with aggregate stats

Includes 44 tests, updated docs/website to reflect 44 agents, and CodeRabbit review fixes (defensive access, type validation, double-count prevention).

* fix: address CodeRabbit review round 2

- Fix primer.mdx example: "29 more agents" → "41 more agents"
- Validate invalid since date in timeline (return empty instead of silent filter-all)
- Guard hist.durationMs with Number.isFinite before formatting
- Fix misleading "commits" label → "changes" for activity log entries
2026-02-14 07:11:44 +00:00
Rohit Ghumare ff089429ae feat: redesign website with aggregator positioning (#67)
* 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"
2026-02-14 07:10:35 +00:00
Rohit Ghumare 6c3cecec4d chore: add v1.19.0 extension zip and remove old one 2026-02-14 11:48:52 +05:30
101 changed files with 5113 additions and 1101 deletions
+1 -1
View File
@@ -35,7 +35,7 @@ assignees: rohitg00
- [ ] Repository is public
- [ ] Repository contains valid SKILL.md files
- [ ] Repository has a clear license
- [ ] Skills follow the [Agent Skills specification](https://agenstskills.com)
- [ ] Skills follow the [Agent Skills specification](https://skillkit.sh)
## Additional Context
+1 -1
View File
@@ -83,7 +83,7 @@ body:
options:
- label: Repository is public
required: true
- label: SKILL.md follows the agenstskills.com standard format
- label: SKILL.md follows the skillkit.sh standard format
required: true
- label: Skill has been tested with at least one AI agent
required: false
+3 -2
View File
@@ -24,8 +24,9 @@ npm-debug.log*
# Environment
.env
.env.local
.env.*.local
**/.env
**/.env.local
**/.env.*.local
# Package manager
yarn.lock
+1 -1
View File
@@ -206,7 +206,7 @@ To add support for a new AI coding agent:
If you want to contribute skills to the ecosystem:
1. Follow the [Agent Skills specification](https://agenstskills.com)
1. Follow the [Agent Skills specification](https://skillkit.sh)
2. Include a `SKILL.md` with proper frontmatter
3. Test with multiple agents using `skillkit translate`
4. Submit to the appropriate skill repository
+16 -6
View File
@@ -17,7 +17,7 @@
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 15,000+ skills in the marketplace.
[Website](https://agenstskills.com) · [Docs](https://agenstskills.com/docs) · [API Explorer](https://agenstskills.com/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
[Website](https://skillkit.sh) · [Docs](https://skillkit.sh/docs) · [API Explorer](https://skillkit.sh/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
</div>
@@ -125,7 +125,7 @@ async with SkillKitClient() as client:
results = await client.search("react performance", limit=5)
```
[REST API docs](https://agenstskills.com/docs/rest-api) &middot; [MCP Server docs](https://agenstskills.com/docs/mcp-server) &middot; [Python Client docs](https://agenstskills.com/docs/python-client) &middot; [Interactive API explorer](https://agenstskills.com/api)
[REST API docs](https://skillkit.sh/docs/rest-api) &middot; [MCP Server docs](https://skillkit.sh/docs/mcp-server) &middot; [Python Client docs](https://skillkit.sh/docs/python-client) &middot; [Interactive API explorer](https://skillkit.sh/api)
### Auto-generate agent instructions
@@ -191,7 +191,7 @@ Save any webpage as a skill directly from your browser.
The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
[Extension docs](https://agenstskills.com/docs/chrome-extension)
[Extension docs](https://skillkit.sh/docs/chrome-extension)
### Interactive TUI
@@ -221,7 +221,7 @@ skillkit ui
Plus 33 more: Amp, Antigravity, Augment Code, Bolt, Clawdbot, Cline, CodeBuddy, CodeGPT, CommandCode, Continue, Crush, Droid, Factory, Goose, Kilo Code, Kiro CLI, Lovable, MCPJam, Mux, Neovate, OpenHands, Pi, PlayCode, Qoder, Qwen, Replit Agent, Roo Code, Tabby, Tabnine, Trae, Vercel, Zencoder, Universal
[Full agent details](https://agenstskills.com/docs/agents)
[Full agent details](https://skillkit.sh/docs/agents)
## Commands
@@ -254,6 +254,16 @@ skillkit issue plan owner/repo#42 # Cross-repo plan
skillkit issue list # List open issues
```
### Session Intelligence
```bash
skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
skillkit session explain # Human-readable summary
skillkit activity # Skill activity log
```
### Advanced
```bash
@@ -266,7 +276,7 @@ skillkit test # Test skills
skillkit cicd init # CI/CD templates
```
[Full command reference](https://agenstskills.com/docs/commands)
[Full command reference](https://skillkit.sh/docs/commands)
## Creating Skills
@@ -357,4 +367,4 @@ Apache License 2.0 — see [LICENSE](LICENSE).
## Links
[Documentation](https://agenstskills.com/docs) &middot; [Website](https://agenstskills.com) &middot; [API Explorer](https://agenstskills.com/api) &middot; [npm](https://www.npmjs.com/package/skillkit) &middot; [GitHub](https://github.com/rohitg00/skillkit)
[Documentation](https://skillkit.sh/docs) &middot; [Website](https://skillkit.sh) &middot; [API Explorer](https://skillkit.sh/api) &middot; [npm](https://www.npmjs.com/package/skillkit) &middot; [GitHub](https://github.com/rohitg00/skillkit)
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.19.0",
"version": "1.19.2",
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
"type": "module",
"bin": {
+7
View File
@@ -118,6 +118,9 @@ import {
AgentsMdShowCommand,
IssuePlanCommand,
IssueListCommand,
TimelineCommand,
SessionHandoffCommand,
LineageCommand,
} from '@skillkit/cli';
const __filename = fileURLToPath(import.meta.url);
@@ -263,4 +266,8 @@ cli.register(AgentsMdShowCommand);
cli.register(IssuePlanCommand);
cli.register(IssueListCommand);
cli.register(TimelineCommand);
cli.register(SessionHandoffCommand);
cli.register(LineageCommand);
cli.runExit(process.argv.slice(2));
+1 -1
View File
@@ -38,5 +38,5 @@ dev = [
[project.urls]
Homepage = "https://github.com/rohitg00/skillkit"
Documentation = "https://agenstskills.com"
Documentation = "https://skillkit.sh"
Repository = "https://github.com/rohitg00/skillkit"
@@ -65,7 +65,7 @@ Extension → POST /api/save-skill { url } → Server pipeline → Download
1. **Popup** reads the current tab's URL and title via `activeTab` permission. No content script injection needed.
2. **Background service worker** sends the URL to `agenstskills.com/api/save-skill`:
2. **Background service worker** sends the URL to `skillkit.sh/api/save-skill` (or `agenstskills.com/api/save-skill`):
- Server fetches the page and converts HTML to markdown via Turndown
- GitHub URLs are auto-converted to raw content
- Tags are detected from 5 weighted sources (URL segments, headings, code blocks, keywords, language)
+60
View File
@@ -378,6 +378,66 @@ skillkit issue list --json # JSON output
The planner extracts task lists (checkboxes) from the issue body, infers file mentions from backtick-quoted paths, and maps labels to tags (e.g., `bug` → `fix`, `enhancement` → `feature`). Generated plans work with `skillkit plan validate` and `skillkit plan execute`.
## Session Intelligence
Track skill executions, generate handoff documents, and analyze skill impact.
### Timeline
View a unified chronological event stream of all session activity.
```bash
skillkit timeline # Last 50 events
skillkit timeline --type git_commit # Filter by event type
skillkit timeline --skill code-simplifier # Filter by skill
skillkit timeline --since 2026-02-10 # Date filter
skillkit timeline --limit 20 --json # JSON output
```
| Option | Short | Purpose |
|--------|-------|---------|
| `--type` | `-t` | Filter: skill_start, skill_complete, task_progress, git_commit, observation, decision, snapshot |
| `--skill` | `-s` | Filter events by skill name |
| `--since` | — | Show events since date (YYYY-MM-DD) |
| `--limit` | `-l` | Max events (default: 50) |
| `--json` | `-j` | JSON output |
### Session Handoff
Generate a structured context document for agent switching.
```bash
skillkit session handoff # Print markdown to stdout
skillkit session handoff --to cursor # Target agent recommendations
skillkit session handoff --out handoff.md # Save to file
skillkit session handoff --json # JSON output
```
| Option | Short | Purpose |
|--------|-------|---------|
| `--to` | — | Target agent for recommendations |
| `--out` | `-o` | Save to file path |
| `--json` | `-j` | JSON output |
### Lineage
Show which skills produced which code changes with aggregate impact stats.
```bash
skillkit lineage # Full overview
skillkit lineage --skill code-simplifier # Single skill
skillkit lineage --file src/index.ts # Single file
skillkit lineage --since 2026-02-01 --json # Date filter + JSON
```
| Option | Short | Purpose |
|--------|-------|---------|
| `--skill` | `-s` | Filter by skill name |
| `--file` | `-f` | Filter by file path |
| `--since` | — | Show lineage since date |
| `--limit` | `-l` | Max entries |
| `--json` | `-j` | JSON output |
## Utility Commands
```bash
+1 -1
View File
@@ -29,7 +29,7 @@ skillkit/
│ ├── core/ # Business logic
│ ├── cli/ # CLI
│ ├── tui/ # Terminal UI
│ └── agents/ # 32 adapters
│ └── agents/ # 44 adapters
├── marketplace/ # Skills data
│ ├── skills.json
│ └── sources.json
+11 -1
View File
@@ -124,6 +124,16 @@ skillkit memory search "auth patterns"
skillkit memory export auth-patterns
```
### Session Intelligence
Track skill executions, generate handoff documents for agent switching, and view skill impact lineage:
```bash
skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
```
### Primer
Auto-generate CLAUDE.md, .cursorrules, and agent instructions by analyzing your codebase:
@@ -163,4 +173,4 @@ Team members run `skillkit manifest install` and they're in sync.
- [MCP Server](/docs/mcp-server) — Agent-native discovery
- [Python Client](/docs/python-client) — Python SDK
**Current version:** v1.12.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
**Current version:** v1.18.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0
+3 -3
View File
@@ -5,7 +5,7 @@ description: Auto-generate AI agent instructions from your codebase
# Primer
Primer analyzes your codebase and automatically generates optimized instructions for all 32 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
Primer analyzes your codebase and automatically generates optimized instructions for all 44 AI agents. No more manual configuration—let SkillKit detect your tech stack, coding patterns, and project structure.
## Quick Start
@@ -65,7 +65,7 @@ Primer creates agent-specific instructions for:
└── copilot-instructions.md
```
### All 32 Agents
### All 44 Agents
Each agent gets optimized instructions in their native format.
## Example Output
@@ -86,7 +86,7 @@ Detected:
- Claude Code (.claude/CLAUDE.md)
- Cursor (.cursor/.cursorrules)
- Codex (.codex/instructions.md)
+ 29 more agents
+ 41 more agents
💡 Tip: Run `skillkit sync` to apply changes
```
+1 -1
View File
@@ -188,7 +188,7 @@ const { app, cache } = createApp({
The server includes built-in Swagger UI at `/docs` and an OpenAPI 3.1 spec at `/openapi.json`. Open `http://localhost:3737/docs` in your browser to try endpoints interactively.
The hosted version is available at [agenstskills.com/api](https://agenstskills.com/api).
The hosted version is available at [skillkit.sh/api](https://skillkit.sh/api) and [agenstskills.com/api](https://agenstskills.com/api).
## All endpoints
+1 -1
View File
@@ -5,7 +5,7 @@ description: Convert skills between AI agent formats
# Translation
SkillKit automatically converts between all 32 agent formats using an adapter pattern.
SkillKit automatically converts between all 44 agent formats using an adapter pattern.
## Basic Translation
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-docs",
"version": "1.19.0",
"version": "1.19.2",
"private": true,
"scripts": {
"build": "next build",
+3 -3
View File
@@ -18,7 +18,7 @@ export default function HomePage() {
<p className="text-lg text-zinc-400 mb-8 max-w-2xl mx-auto font-mono">
One CLI to install, sync, and manage skills across Claude Code, Cursor,
Windsurf, Copilot, and 28 more agents. 15,000+ skills ready to use.
Windsurf, Copilot, and 40 more agents. 15,000+ skills ready to use.
</p>
<div className="flex flex-wrap justify-center gap-4 mb-12">
@@ -39,8 +39,8 @@ export default function HomePage() {
{/* Features Grid */}
<div className="grid grid-cols-1 md:grid-cols-3 gap-6 mb-16">
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
<h3 className="text-lg font-bold text-white mb-2 font-mono">32 Agents</h3>
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 27 more supported out of the box.</p>
<h3 className="text-lg font-bold text-white mb-2 font-mono">44 Agents</h3>
<p className="text-zinc-500 text-sm">Claude, Cursor, Codex, Windsurf, Copilot, and 39 more supported out of the box.</p>
</div>
<div className="border border-zinc-800 bg-zinc-900/30 p-6">
<h3 className="text-lg font-bold text-white mb-2 font-mono">15,000+ Skills</h3>
+1 -1
View File
@@ -24,7 +24,7 @@ export const metadata: Metadata = {
openGraph: {
title: 'SkillKit - Universal Skills for AI Coding Agents',
description: 'One CLI to install, sync, and manage skills across Claude Code, Cursor, Windsurf, Copilot, and 28 more agents.',
url: 'https://agenstskills.com',
url: 'https://skillkit.sh',
siteName: 'SkillKit',
images: [{ url: '/og-image.png', width: 1200, height: 630 }],
type: 'website',
+16 -4
View File
@@ -44,12 +44,12 @@ const sections: DocSection[] = [
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 32 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
SkillKit is a universal command-line interface (CLI) and programmatic toolkit for managing AI agent skills across 44 AI coding platforms. It solves the fragmentation problem where each AI agent uses different skill formats and directory structures.
</p>
<h3 className="text-lg font-semibold text-white mt-6">Core Capabilities</h3>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">Skill Discovery</span> - Browse 15,000+ skills from marketplace with AI-powered recommendations</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 32 agent-specific formats</li>
<li><span className="text-white">Cross-Agent Translation</span> - Automatically convert skills between 44 agent-specific formats</li>
<li><span className="text-white">Team Collaboration</span> - Share skills via .skills manifest files and publish to marketplace</li>
</ul>
</div>
@@ -102,7 +102,7 @@ skillkit install anthropics/skills`}</CodeBlock>
<ul className="list-disc list-inside space-y-2 text-zinc-400">
<li><span className="text-white">UI Tier</span> - CLI commands, Terminal UI (OpenTUI-based), and documentation website</li>
<li><span className="text-white">Core Logic Tier</span> - @skillkit/core for business logic; @skillkit/agents for adapter implementations</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 32 AI agents</li>
<li><span className="text-white">Integration Tier</span> - File systems, Git repositories, marketplace APIs, and 44 AI agents</li>
</ul>
<h3 className="text-lg font-semibold text-white mt-6">Monorepo Structure</h3>
@@ -130,7 +130,7 @@ skillkit install anthropics/skills`}</CodeBlock>
content: (
<div className="space-y-4">
<p className="text-zinc-300">
SkillKit supports 32 AI coding agents with automatic format translation:
SkillKit supports 44 AI coding agents with automatic format translation:
</p>
<Table
@@ -167,6 +167,18 @@ skillkit install anthropics/skills`}</CodeBlock>
['Trae', '.trae/skills/', 'SKILL.md'],
['Vercel', '.vercel/skills/', 'SKILL.md'],
['Zencoder', '.zencoder/skills/', 'SKILL.md'],
['Devin', '.devin/skills/', 'SKILL.md'],
['Aider', '.aider/skills/', 'SKILL.md'],
['Sourcegraph Cody', '.cody/skills/', 'SKILL.md'],
['Amazon Q', '.amazonq/skills/', 'SKILL.md'],
['Augment Code', '.augment/skills/', 'SKILL.md'],
['Replit Agent', '.replit/skills/', 'SKILL.md'],
['Bolt', '.bolt/skills/', 'SKILL.md'],
['Lovable', '.lovable/skills/', 'SKILL.md'],
['Tabby', '.tabby/skills/', 'SKILL.md'],
['Tabnine', '.tabnine/skills/', 'SKILL.md'],
['CodeGPT', '.codegpt/skills/', 'SKILL.md'],
['PlayCode Agent', '.playcode/skills/', 'SKILL.md'],
['Universal', 'skills/', 'SKILL.md'],
]}
/>
+3 -3
View File
@@ -9,7 +9,7 @@ interface Feature {
const FEATURES: Feature[] = [
{
title: 'Multi-Agent',
description: 'Deploy to 32 AI coding agents with one command.',
description: 'Deploy to 44 AI coding agents with one command.',
icon: (
<svg className="w-5 h-5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M19 11H5m14 0a2 2 0 012 2v6a2 2 0 01-2 2H5a2 2 0 01-2-2v-6a2 2 0 012-2m14 0V9a2 2 0 00-2-2M5 11V9a2 2 0 012-2m0 0V5a2 2 0 012-2h6a2 2 0 012 2v2M7 7h10" />
@@ -64,7 +64,7 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agents', '1', '32'],
['Agents', '1', '44'],
['Translation', 'Manual', 'Auto'],
['Sharing', 'Copy/paste', '.skills manifest'],
['Discovery', 'Forums', 'CLI + AI'],
@@ -83,7 +83,7 @@ export function Features(): React.ReactElement {
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">32</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
</div>
<div>
+1 -1
View File
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agenstskills.com"
href="https://skillkit.sh"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
+1
View File
@@ -1,5 +1,6 @@
{
"$schema": "https://openapi.vercel.sh/vercel.json",
"ignoreCommand": "git diff --quiet HEAD^ HEAD -- .",
"buildCommand": "next build",
"installCommand": "npm install",
"outputDirectory": ".next",
+44 -70
View File
@@ -5,14 +5,10 @@ import { Agents } from './components/Agents';
import { Footer } from './components/Footer';
import { SkillGenerator } from './components/SkillGenerator';
import { SkillSubmitForm } from './components/SkillSubmitForm';
import { Commands } from './components/Commands';
import { StackBuilder } from './components/StackBuilder';
import { TrendingSkills } from './components/TrendingSkills';
import { Attribution } from './components/Attribution';
import { AdvancedFeatures } from './components/AdvancedFeatures';
import { UseCases } from './components/UseCases';
import { TeamEnterprise } from './components/TeamEnterprise';
import { BadgeGenerator } from './components/BadgeGenerator';
import { CompatibilityMatrix } from './components/CompatibilityMatrix';
import { useStats } from './hooks/useStats';
@@ -56,13 +52,6 @@ export default function App(): React.ReactElement {
>
Trending
</a>
<a
href="#stack"
onClick={(e) => scrollToSection(e, 'stack')}
className="text-zinc-500 hover:text-white transition-colors"
>
Stack
</a>
<a
href="#matrix"
onClick={(e) => scrollToSection(e, 'matrix')}
@@ -70,13 +59,6 @@ export default function App(): React.ReactElement {
>
Matrix
</a>
<a
href="#badge"
onClick={(e) => scrollToSection(e, 'badge')}
className="text-zinc-500 hover:text-white transition-colors"
>
Badge
</a>
<a
href="#advanced"
onClick={(e) => scrollToSection(e, 'advanced')}
@@ -98,28 +80,20 @@ export default function App(): React.ReactElement {
>
Generator
</a>
<a
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-500 hover:text-white transition-colors"
>
Extension
</a>
</div>
<div className="flex items-center gap-3 sm:gap-4">
<a
href="/docs"
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
>
Docs
</a>
<a
href="/api"
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
>
API
</a>
<a
href="https://agenstskills.com/docs"
className="text-zinc-400 hover:text-white transition-colors text-xs sm:text-sm font-mono"
>
Docs
</a>
<a
href="https://github.com/rohitg00/skillkit"
target="_blank"
@@ -187,44 +161,6 @@ export default function App(): React.ReactElement {
{/* Core Features & Comparison - Value prop at a glance */}
<Features />
{/* Trending Skills - Social proof, what's popular */}
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
<TrendingSkills />
</section>
{/* Stack Builder - Interactive, engaging */}
<section id="stack" style={{ scrollMarginTop: '4rem' }}>
<StackBuilder />
</section>
{/* Compatibility Matrix */}
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
<CompatibilityMatrix />
</section>
{/* Badge Generator */}
<section id="badge" style={{ scrollMarginTop: '4rem' }}>
<BadgeGenerator />
</section>
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
<AdvancedFeatures />
</section>
{/* Commands Reference */}
<Commands />
{/* Real-World Use Cases */}
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
<UseCases />
</section>
{/* Team & Enterprise */}
<section id="team" style={{ scrollMarginTop: '4rem' }}>
<TeamEnterprise />
</section>
{/* Skill Generator */}
<section id="skills" className="py-12 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
<SkillGenerator />
@@ -243,6 +179,44 @@ export default function App(): React.ReactElement {
</div>
</section>
{/* Trending Skills - Social proof, what's popular */}
<section id="trending" style={{ scrollMarginTop: '4rem' }}>
<TrendingSkills />
</section>
{/* Compatibility Matrix */}
<section id="matrix" style={{ scrollMarginTop: '4rem' }}>
<CompatibilityMatrix />
</section>
{/* Advanced Capabilities: Memory, Primer, Mesh, Messaging */}
<section id="advanced" style={{ scrollMarginTop: '4rem' }}>
<AdvancedFeatures />
</section>
{/* Docs CTA */}
<section className="py-8 border-b border-zinc-800">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 text-center">
<p className="text-sm font-mono text-zinc-400">
Explore all 50+ commands, team workflows, and integrations in the{' '}
<a
href="/docs"
target="_blank"
rel="noopener noreferrer"
className="text-white underline underline-offset-4 hover:text-zinc-300 transition-colors"
>
documentation
</a>
.
</p>
</div>
</section>
{/* Real-World Use Cases */}
<section id="use-cases" style={{ scrollMarginTop: '4rem' }}>
<UseCases />
</section>
{/* Attribution & Sources */}
<section id="sources" style={{ scrollMarginTop: '4rem' }}>
<Attribution />
@@ -47,6 +47,24 @@ const ADVANCED_FEATURES: AdvancedFeature[] = [
{ cmd: 'memory --global', desc: 'Share across all projects' },
],
},
{
id: 'session',
title: 'Session Intelligence',
subtitle: 'Skill Lineage & Agent Handoffs',
description: 'Track which skills produced which code changes. Generate handoff documents when switching agents. View unified timelines of all session events — skill executions, git commits, observations, and decisions in one stream.',
highlight: 'Timeline, handoff, and lineage in one place',
icon: (
<svg className="w-8 h-8" fill="none" viewBox="0 0 24 24" stroke="currentColor">
<path strokeLinecap="round" strokeLinejoin="round" strokeWidth={1.5} d="M12 8v4l3 3m6-3a9 9 0 11-18 0 9 9 0 0118 0z" />
</svg>
),
commands: [
{ cmd: 'timeline', desc: 'Unified event stream' },
{ cmd: 'session handoff', desc: 'Agent-to-agent context' },
{ cmd: 'lineage', desc: 'Skill impact graph' },
{ cmd: 'lineage --skill code-simplifier', desc: 'Per-skill impact' },
],
},
{
id: 'primer',
title: 'Primer',
+2 -2
View File
@@ -35,8 +35,8 @@ export function BadgeGenerator(): React.ReactElement {
const badgeUrl = useMemo(() => buildBadgeUrl(skills), [skills]);
const markdown = `[![SkillKit Stack](${badgeUrl})](https://agenstskills.com)`;
const html = `<a href="https://agenstskills.com"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
const markdown = `[![SkillKit Stack](${badgeUrl})](https://skillkit.sh)`;
const html = `<a href="https://skillkit.sh"><img src="${badgeUrl}" alt="SkillKit Stack" /></a>`;
function addSkill(skill: string): void {
const trimmed = skill.trim().toLowerCase();
+11
View File
@@ -104,6 +104,17 @@ const COMMAND_GROUPS: CommandGroup[] = [
{ cmd: 'issue list --label bug', desc: 'Filter by label' },
],
},
{
name: 'Session',
commands: [
{ cmd: 'timeline', desc: 'Unified event stream' },
{ cmd: 'session handoff', desc: 'Agent handoff doc' },
{ cmd: 'lineage', desc: 'Skill impact graph' },
{ cmd: 'session explain', desc: 'Session summary' },
{ cmd: 'activity', desc: 'Skill activity log' },
{ cmd: 'session snapshot save', desc: 'Save state' },
],
},
{
name: 'Advanced',
commands: [
@@ -24,14 +24,42 @@ const AGENTS: AgentDef[] = [
{ id: 'windsurf', name: 'Windsurf', icon: '\u25C7', group: 'Tier 1' },
{ id: 'github-copilot', name: 'Copilot', icon: '\u2318', group: 'Tier 1' },
{ id: 'cline', name: 'Cline', icon: '\u25CF', group: 'Tier 1' },
{ id: 'devin', name: 'Devin', icon: '\u25C9', group: 'Tier 1' },
{ id: 'roo', name: 'Roo', icon: '\u25C6', group: 'Tier 2' },
{ id: 'kilo', name: 'Kilo', icon: '\u25B3', group: 'Tier 2' },
{ id: 'kiro-cli', name: 'Kiro CLI', icon: '\u25BD', group: 'Tier 2' },
{ id: 'goose', name: 'Goose', icon: '\u25CA', group: 'Tier 2' },
{ id: 'trae', name: 'Trae', icon: '\u25A0', group: 'Tier 2' },
{ id: 'amp', name: 'AMP', icon: '\u26A1', group: 'Tier 2' },
{ id: 'aider', name: 'Aider', icon: '\u25E6', group: 'Tier 2' },
{ id: 'cody', name: 'Cody', icon: '\u25D0', group: 'Tier 2' },
{ id: 'amazon-q', name: 'Amazon Q', icon: '\u25A3', group: 'Tier 2' },
{ id: 'antigravity', name: 'Antigrav', icon: '\u2191', group: 'Tier 3' },
{ id: 'continue', name: 'Continue', icon: '\u25B6', group: 'Tier 3' },
{ id: 'augment', name: 'Augment', icon: '\u25C8', group: 'Tier 3' },
{ id: 'replit', name: 'Replit', icon: '\u25B7', group: 'Tier 3' },
{ id: 'bolt', name: 'Bolt', icon: '\u2605', group: 'Tier 3' },
{ id: 'lovable', name: 'Lovable', icon: '\u2665', group: 'Tier 3' },
{ id: 'tabby', name: 'Tabby', icon: '\u25AB', group: 'Tier 3' },
{ id: 'tabnine', name: 'Tabnine', icon: '\u25AA', group: 'Tier 3' },
{ id: 'codegpt', name: 'CodeGPT', icon: '\u25E7', group: 'Tier 3' },
{ id: 'playcode', name: 'PlayCode', icon: '\u25B9', group: 'Tier 3' },
{ id: 'clawdbot', name: 'Clawdbot', icon: '\u25D1', group: 'Tier 3' },
{ id: 'droid', name: 'Droid', icon: '\u25D2', group: 'Tier 3' },
{ id: 'codebuddy', name: 'CodeBuddy', icon: '\u25D3', group: 'Tier 3' },
{ id: 'commandcode', name: 'CmdCode', icon: '\u25D4', group: 'Tier 3' },
{ id: 'crush', name: 'Crush', icon: '\u25D5', group: 'Tier 3' },
{ id: 'factory', name: 'Factory', icon: '\u25D6', group: 'Tier 3' },
{ id: 'mcpjam', name: 'MCPJam', icon: '\u25D7', group: 'Tier 3' },
{ id: 'mux', name: 'Mux', icon: '\u25E0', group: 'Tier 3' },
{ id: 'neovate', name: 'Neovate', icon: '\u25E1', group: 'Tier 3' },
{ id: 'openhands', name: 'OpenHands', icon: '\u25E2', group: 'Tier 3' },
{ id: 'pi', name: 'Pi', icon: '\u25E3', group: 'Tier 3' },
{ id: 'qoder', name: 'Qoder', icon: '\u25E4', group: 'Tier 3' },
{ id: 'qwen', name: 'Qwen', icon: '\u25E5', group: 'Tier 3' },
{ id: 'vercel', name: 'Vercel', icon: '\u25B2', group: 'Tier 3' },
{ id: 'zencoder', name: 'Zencoder', icon: '\u25E8', group: 'Tier 3' },
{ id: 'universal', name: 'Universal', icon: '\u25CB', group: 'Tier 3' },
];
const CATEGORIES: CategoryDef[] = [
@@ -56,66 +84,87 @@ const CATEGORIES: CategoryDef[] = [
// - windsurf: 32K context, no MCP/tools, workflow YAML format
// - kilo, kiro-cli: XML block format, multi-mode support, no MCP
// - goose, amp, antigravity, trae, continue: varies, mostly universal adapter
const T3_FULL: Record<string, Support> = {
'augment': 'full', 'replit': 'full', 'bolt': 'full', 'lovable': 'full',
'tabby': 'full', 'tabnine': 'full', 'codegpt': 'full', 'playcode': 'full',
'clawdbot': 'full', 'droid': 'full', 'codebuddy': 'full', 'commandcode': 'full',
'crush': 'full', 'factory': 'full', 'mcpjam': 'full', 'mux': 'full',
'neovate': 'full', 'openhands': 'full', 'pi': 'full', 'qoder': 'full',
'qwen': 'full', 'vercel': 'full', 'zencoder': 'full', 'universal': 'full',
};
const T3_PARTIAL: Record<string, Support> = Object.fromEntries(Object.keys(T3_FULL).map(k => [k, 'partial']));
const T3_NONE: Record<string, Support> = Object.fromEntries(Object.keys(T3_FULL).map(k => [k, 'none']));
const MATRIX: Record<string, Record<string, Support>> = {
'translation': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'full', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'partial', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'full', 'continue': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'partial', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
'antigravity': 'full', 'continue': 'full', ...T3_FULL,
},
'hooks': {
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'partial',
'opencode': 'partial', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'antigravity': 'none', 'continue': 'none',
'devin': 'partial', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'aider': 'none', 'cody': 'none', 'amazon-q': 'none',
'antigravity': 'none', 'continue': 'none', ...T3_NONE,
},
'mcp-tools': {
'claude-code': 'full', 'cursor': 'none', 'codex': 'none', 'gemini-cli': 'none',
'opencode': 'none', 'windsurf': 'none', 'github-copilot': 'none', 'cline': 'full',
'roo': 'full', 'kilo': 'none', 'kiro-cli': 'none', 'goose': 'none',
'trae': 'none', 'amp': 'none', 'antigravity': 'none', 'continue': 'none',
'devin': 'partial', 'roo': 'full', 'kilo': 'none', 'kiro-cli': 'none', 'goose': 'none',
'trae': 'none', 'amp': 'none', 'aider': 'none', 'cody': 'none', 'amazon-q': 'none',
'antigravity': 'none', 'continue': 'none', ...T3_NONE,
},
'context': {
'claude-code': 'full', 'cursor': 'partial', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'partial', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'partial', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'security': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'testing': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'frontend': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'devin': 'full', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'full', 'amp': 'full', 'aider': 'partial', 'cody': 'partial', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'backend': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'partial', 'continue': 'partial',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'devops': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'partial', 'github-copilot': 'partial', 'cline': 'full',
'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'antigravity': 'partial', 'continue': 'partial',
'devin': 'full', 'roo': 'full', 'kilo': 'partial', 'kiro-cli': 'partial', 'goose': 'partial',
'trae': 'partial', 'amp': 'partial', 'aider': 'partial', 'cody': 'partial', 'amazon-q': 'partial',
'antigravity': 'partial', 'continue': 'partial', ...T3_PARTIAL,
},
'docs': {
'claude-code': 'full', 'cursor': 'full', 'codex': 'partial', 'gemini-cli': 'full',
'opencode': 'full', 'windsurf': 'full', 'github-copilot': 'full', 'cline': 'full',
'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'antigravity': 'full', 'continue': 'full',
'devin': 'full', 'roo': 'full', 'kilo': 'full', 'kiro-cli': 'full', 'goose': 'full',
'trae': 'full', 'amp': 'full', 'aider': 'full', 'cody': 'full', 'amazon-q': 'full',
'antigravity': 'full', 'continue': 'full', ...T3_FULL,
},
};
@@ -197,7 +246,7 @@ export function CompatibilityMatrix(): React.ReactElement {
<div>
<h2 className="text-lg sm:text-xl font-bold text-white mb-1 font-mono">Compatibility Matrix</h2>
<p className="text-zinc-500 font-mono text-[10px] sm:text-xs">
Skill support across {AGENTS.length} agents and {CATEGORIES.length} categories.
Skill support across all 44 agents and {CATEGORIES.length} categories.
</p>
</div>
<div className="flex items-center gap-2">
@@ -213,6 +213,13 @@ skillkit primer --dry-run # Preview without writing files
skillkit primer --json # Output analysis as JSON
skillkit primer --output ./dir # Custom output directory`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Session Intelligence</h3>
<CodeBlock>{`skillkit timeline # Unified event stream
skillkit session handoff # Agent-to-agent context
skillkit lineage # Skill impact graph
skillkit session explain # Session summary
skillkit activity # Skill activity log`}</CodeBlock>
<h3 className="text-lg font-semibold text-white mt-6">Advanced</h3>
<CodeBlock>{`skillkit ui # Launch Terminal UI
skillkit workflow # Manage workflows
+21 -21
View File
@@ -109,34 +109,34 @@ const FEATURES: Feature[] = [
];
const COMPARISONS = [
['Agent Support', '1 agent', '44 agents'],
['Setup', 'Write rules manually', 'Auto-generate (Primer)'],
['Learning', 'Lost each session', 'Persistent memory'],
['Translation', 'Rewrite for each', 'One-click conversion'],
['Team Sharing', 'Copy/paste files', '.skills manifest'],
['Discovery', 'Search forums', 'AI recommendations'],
['Security', 'Manual review', 'Auto-scan on install'],
['Agent Support', '1-17 agents', '44 agents'],
['Sources', 'Single registry', '31+ aggregated'],
['Translation', 'None or limited', 'All 44 formats'],
['Memory', 'None', 'Persistent learning'],
['Security', 'None', '46-rule scanner'],
['Team Sync', 'None', '.skills manifest'],
['Telemetry', 'Varies', 'Zero. Ever.'],
['API Access', 'None', 'REST + MCP + Python'],
] as const;
export function Features(): React.ReactElement {
return (
<section id="features" className="py-12 border-b border-zinc-800 bg-surface">
<section id="features" className="py-8 border-b border-zinc-800 bg-surface">
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-10">
<div className="grid grid-cols-1 lg:grid-cols-5 gap-6 lg:gap-8 mb-6">
<div className="lg:col-span-2">
<h2 className="text-xl font-bold text-white mb-2 font-mono">Why SkillKit?</h2>
<h2 className="text-xl font-bold text-white mb-2 font-mono">At a Glance</h2>
<p className="text-zinc-500 font-mono text-sm mb-6">
Universal bridge for AI coding agents.
What you get vs. a simple installer.
</p>
<div className="flex gap-6 sm:gap-8">
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">32</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">44</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Agents</div>
</div>
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">50+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Commands</div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">31+</div>
<div className="text-zinc-600 text-[10px] sm:text-xs font-mono">Sources</div>
</div>
<div>
<div className="text-2xl sm:text-3xl font-bold text-white font-mono">15K+</div>
@@ -147,8 +147,8 @@ export function Features(): React.ReactElement {
<div className="lg:col-span-3 border border-zinc-800 bg-black/50 p-4 font-mono text-xs backdrop-blur-sm">
<div className="grid grid-cols-3 gap-2 border-b border-zinc-800 pb-2 mb-3 text-zinc-500 uppercase tracking-wider text-[10px]">
<div>Feature</div>
<div className="text-center">Without</div>
<div>Capability</div>
<div className="text-center">Simple Installers</div>
<div className="text-right">SkillKit</div>
</div>
<div className="space-y-1">
@@ -167,20 +167,20 @@ export function Features(): React.ReactElement {
</div>
</div>
<div className="grid grid-cols-2 sm:grid-cols-3 gap-3">
<div className="grid grid-cols-3 sm:grid-cols-4 gap-2">
{FEATURES.map((feature, index) => (
<div
key={feature.title}
className="group relative p-4 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
className="group relative p-2.5 border border-zinc-800 bg-zinc-900/30 hover:bg-zinc-900/80 hover:border-zinc-700 transition-all duration-300 cursor-default"
style={{ animationDelay: `${index * 50}ms` }}
>
<div className="absolute inset-0 bg-gradient-to-b from-zinc-800/0 to-zinc-800/20 opacity-0 group-hover:opacity-100 transition-opacity"></div>
<div className="relative">
<div className="text-zinc-500 group-hover:text-white transition-colors mb-2">
<div className="text-zinc-500 group-hover:text-white transition-colors mb-1">
{feature.icon}
</div>
<h4 className="text-xs font-bold text-white mb-1 font-mono">{feature.title}</h4>
<p className="text-zinc-600 text-[10px] leading-relaxed font-mono group-hover:text-zinc-400 transition-colors">
<h4 className="text-[11px] font-bold text-white mb-0.5 font-mono">{feature.title}</h4>
<p className="text-zinc-600 text-[10px] leading-snug font-mono group-hover:text-zinc-400 transition-colors">
{feature.description}
</p>
</div>
+1 -1
View File
@@ -18,7 +18,7 @@ export function Footer(): React.ReactElement {
</p>
<span className="hidden sm:inline text-zinc-700">•</span>
<a
href="https://agenstskills.com"
href="https://skillkit.sh"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-600 hover:text-zinc-400 text-xs font-mono transition-colors"
+16 -14
View File
@@ -20,16 +20,18 @@ interface TerminalLine {
}
const TERMINAL_LINES: TerminalLine[] = [
{ type: 'cmd', text: 'skillkit install anthropics/skills --agent all' },
{ type: 'out', text: '→ Installed to 44 agents' },
{ type: 'cmd', text: 'skillkit install anthropics/skills' },
{ type: 'out', text: '→ Fetched from github.com/anthropics/skills' },
{ type: 'out', text: '→ Translated to 44 agent formats' },
{ type: 'out', text: '→ Scanned: 0 issues found' },
{ type: 'cmd', text: 'skillkit install vercel-labs/agent-skills' },
{ type: 'out', text: '→ Installed 12 skills from Vercel' },
{ type: 'cmd', text: 'skillkit translate --all --to cursor' },
{ type: 'out', text: '→ 26 skills → .cursor/skills/' },
{ type: 'cmd', text: 'skillkit recommend' },
{ type: 'out', text: ' 92% vercel-react-best-practices' },
{ type: 'out', text: ' 87% typescript-strict-mode' },
{ type: 'cmd', text: 'skillkit serve' },
{ type: 'out', text: '→ API server on http://0.0.0.0:3737' },
{ type: 'out', text: ' GET /search · /trending · /categories' },
{ type: 'cmd', text: 'curl localhost:3737/search?q=react' },
{ type: 'out', text: ' {"skills":[...],"total":42}' },
{ type: 'out', text: ' 92% react-best-practices (vercel)' },
{ type: 'out', text: ' 87% strict-typescript (anthropic)' },
{ type: 'out', text: ' 85% supabase-auth (supabase)' },
];
const FADE_ANIMATION_STYLES = `
@@ -141,14 +143,14 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
</div>
<h1 className="text-2xl sm:text-3xl lg:text-4xl font-bold tracking-tight text-white mb-3 font-mono">
One Skill.<br />
<span className="text-zinc-500">44 Agents. Zero Rewrites.</span>
One CLI. Every Source.<br />
<span className="text-zinc-500">Every Agent. Zero Telemetry.</span>
</h1>
<p className="text-sm text-zinc-400 mb-5 max-w-lg font-mono leading-relaxed">
The open source package manager for AI agent skills. Install from 15,000+ skills,
auto-translate between formats, persist learnings with Memory.
Works with Claude, Cursor, Windsurf, Copilot, Devin, Codex, and 38 more.
The open source package manager that aggregates 31+ skill sources,
auto-translates to 44 agent formats, and adds memory, security scanning,
and team workflows. No account required. Everything runs locally.
</p>
<div className="flex flex-wrap items-center gap-2 mb-4">
+2 -2
View File
@@ -92,7 +92,7 @@ export function TeamEnterprise(): React.ReactElement {
</p>
</div>
<a
href="https://agenstskills.com/docs/api-reference"
href="https://skillkit.sh/docs/api-reference"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 px-3 sm:px-4 py-2 bg-zinc-800 text-white font-mono text-xs sm:text-sm hover:bg-zinc-700 transition-colors border border-zinc-700 whitespace-nowrap"
@@ -108,7 +108,7 @@ export function TeamEnterprise(): React.ReactElement {
{/* Bottom CTA */}
<div className="mt-6 sm:mt-8 text-center">
<a
href="https://agenstskills.com/docs"
href="https://skillkit.sh/docs"
target="_blank"
rel="noopener noreferrer"
className="inline-flex items-center gap-2 px-4 sm:px-6 py-2.5 sm:py-3 bg-white text-black font-mono text-xs sm:text-sm hover:bg-zinc-200 transition-colors cursor-pointer"
+159
View File
@@ -0,0 +1,159 @@
import React from 'react';
interface Competitor {
name: string;
type: string;
agents: string;
translate: boolean;
memory: boolean;
security: boolean;
team: boolean;
tui: boolean;
api: boolean;
}
const COMPETITORS: Competitor[] = [
{ name: 'Vercel skills', type: 'Installer', agents: '~17', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'PRPM', type: 'Registry', agents: '~6', translate: true, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'Askill', type: 'Installer', agents: '~40', translate: false, memory: false, security: true, team: false, tui: false, api: false },
{ name: 'Skild', type: 'Installer', agents: '~7', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'Paks', type: 'Installer', agents: '~6', translate: false, memory: false, security: false, team: false, tui: false, api: false },
{ name: 'SkillKit', type: 'Platform', agents: '44', translate: true, memory: true, security: true, team: true, tui: true, api: true },
];
const SOURCES = [
{ name: 'Anthropic', repo: 'anthropics/skills', official: true },
{ name: 'Vercel', repo: 'vercel-labs/agent-skills', official: true },
{ name: 'Expo', repo: 'expo/skills', official: true },
{ name: 'Supabase', repo: 'supabase/agent-skills', official: true },
{ name: 'Stripe', repo: 'stripe/ai', official: true },
{ name: 'Remotion', repo: 'remotion-dev/skills', official: true },
{ name: 'Trail of Bits', repo: 'trailofbits/skills', official: false },
{ name: 'Better Auth', repo: 'better-auth/skills', official: false },
{ name: 'ElysiaJS', repo: 'elysiajs/skills', official: false },
{ name: 'Nuxt', repo: 'onmax/nuxt-skills', official: false },
{ name: 'NestJS', repo: 'kadajett/agent-nestjs-skills', official: false },
{ name: 'Three.js', repo: 'cloudai-x/threejs-skills', official: false },
];
function Check(): React.ReactElement {
return <span className="text-green-400 text-xs font-bold">&#10003;</span>;
}
function Cross(): React.ReactElement {
return <span className="text-zinc-700 text-xs">&#8212;</span>;
}
export function WhySkillKit(): React.ReactElement {
return (
<section id="why" className="py-12 sm:py-16 border-b border-zinc-800" style={{ scrollMarginTop: '4rem' }}>
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8">
<div className="text-center mb-8 sm:mb-12">
<div className="inline-flex items-center gap-2 border border-zinc-700 bg-zinc-900/80 px-2 sm:px-3 py-1 mb-4 backdrop-blur-sm">
<span className="w-1.5 h-1.5 bg-white rounded-full"></span>
<span className="text-[10px] sm:text-xs font-mono text-zinc-300 uppercase tracking-wider">Not Another Installer</span>
</div>
<h2 className="text-2xl sm:text-3xl lg:text-4xl font-bold text-white mb-3 font-mono tracking-tight">
Others Install. SkillKit Orchestrates.
</h2>
<p className="text-zinc-400 font-mono text-xs sm:text-sm max-w-2xl mx-auto">
Most skill tools are simple installers with 3-5 commands.
SkillKit is a full platform that aggregates every source, translates to every format,
and adds memory, security, and team workflows on top.
</p>
</div>
<div className="overflow-x-auto -mx-4 px-4 sm:mx-0 sm:px-0 mb-12">
<div className="min-w-[640px]">
<table className="w-full border-collapse font-mono text-[10px] sm:text-xs">
<thead>
<tr className="border-b border-zinc-800">
<th className="text-left text-zinc-500 uppercase tracking-wider py-2 pr-3">Tool</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Agents</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Translate</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Memory</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Security</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">Team</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">TUI</th>
<th className="px-2 py-2 text-center text-zinc-500 uppercase tracking-wider">API</th>
</tr>
</thead>
<tbody>
{COMPETITORS.map((c) => {
const isSkillKit = c.name === 'SkillKit';
const rowClass = isSkillKit
? 'bg-white/[0.03] border-b border-zinc-700'
: 'border-b border-zinc-800/50 hover:bg-zinc-900/50';
const nameClass = isSkillKit ? 'text-white font-bold' : 'text-zinc-400';
return (
<tr key={c.name} className={rowClass}>
<td className="py-2.5 pr-3">
<div className="flex items-center gap-2">
<span className={nameClass}>{c.name}</span>
<span className="text-zinc-700 text-[9px]">{c.type}</span>
</div>
</td>
<td className={`px-2 py-2.5 text-center ${isSkillKit ? 'text-white font-bold' : 'text-zinc-500'}`}>{c.agents}</td>
<td className="px-2 py-2.5 text-center">{c.translate ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.memory ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.security ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.team ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.tui ? <Check /> : <Cross />}</td>
<td className="px-2 py-2.5 text-center">{c.api ? <Check /> : <Cross />}</td>
</tr>
);
})}
</tbody>
</table>
</div>
</div>
<div className="mb-8">
<h3 className="text-lg font-bold text-white mb-2 font-mono">
One CLI. Every Source. Zero Telemetry.
</h3>
<p className="text-zinc-400 font-mono text-xs sm:text-sm mb-6">
SkillKit doesn't compete with skill sources &mdash; it aggregates them.
Install from 31+ curated repositories, any GitHub/GitLab repo, or local paths.
Everything runs locally. No accounts, no tracking, no lock-in.
</p>
<div className="grid grid-cols-2 sm:grid-cols-3 md:grid-cols-4 gap-2">
{SOURCES.map((s) => (
<a
key={s.repo}
href={`https://github.com/${s.repo}`}
target="_blank"
rel="noopener noreferrer"
className="group flex items-center gap-2 px-3 py-2 border border-zinc-800 bg-zinc-900/30 hover:border-zinc-600 hover:bg-zinc-900/80 transition-all"
>
<span className="text-zinc-400 group-hover:text-white text-xs font-mono transition-colors">{s.name}</span>
{s.official && (
<span className="text-[8px] text-zinc-600 border border-zinc-800 px-1 py-0.5 uppercase tracking-wider">official</span>
)}
</a>
))}
<div className="flex items-center gap-2 px-3 py-2 border border-dashed border-zinc-800 text-zinc-600 text-xs font-mono">
+ 19 more community sources
</div>
</div>
</div>
<div className="grid grid-cols-1 sm:grid-cols-3 gap-3">
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
<div className="text-2xl font-bold text-white font-mono mb-1">0 bytes</div>
<div className="text-zinc-500 text-xs font-mono">telemetry collected</div>
</div>
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
<div className="text-2xl font-bold text-white font-mono mb-1">Apache 2.0</div>
<div className="text-zinc-500 text-xs font-mono">fully open source</div>
</div>
<div className="p-4 border border-zinc-800 bg-zinc-900/30">
<div className="text-2xl font-bold text-white font-mono mb-1">No account</div>
<div className="text-zinc-500 text-xs font-mono">required to use</div>
</div>
</div>
</div>
</section>
);
}
+4 -4
View File
@@ -8,20 +8,20 @@
<!-- Open Graph -->
<meta property="og:type" content="website">
<meta property="og:url" content="https://agenstskills.com/">
<meta property="og:url" content="https://skillkit.sh/">
<meta property="og:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta property="og:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta property="og:image" content="https://agenstskills.com/og-image.png">
<meta property="og:image" content="https://skillkit.sh/og-image.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta property="og:site_name" content="SkillKit">
<!-- Twitter -->
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:url" content="https://agenstskills.com/">
<meta name="twitter:url" content="https://skillkit.sh/">
<meta name="twitter:title" content="SkillKit - Universal Skills for AI Coding Agents">
<meta name="twitter:description" content="Write once, deploy to 44 AI coding agents. Skills for Claude Code, Cursor, Codex, Windsurf, GitHub Copilot, and more.">
<meta name="twitter:image" content="https://agenstskills.com/og-image.png">
<meta name="twitter:image" content="https://skillkit.sh/og-image.png">
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
<link rel="icon" type="image/png" sizes="32x32" href="/favicon-32.png" />
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.19.0",
"version": "1.19.2",
"type": "module",
"scripts": {
"dev": "vite",
+3 -3
View File
@@ -32,7 +32,7 @@
<h2>Chrome Extension — "SkillKit - Save as Skill"</h2>
<p>The Chrome extension helps you save webpages as AI agent skill files.</p>
<ul>
<li><strong>What data is sent:</strong> When you click "Save as Skill", the extension sends the URL of the current page to our server at <code>agenstskills.com/api/save-skill</code>. This is required to fetch and convert the webpage content into a skill file.</li>
<li><strong>What data is sent:</strong> When you click "Save as Skill", the extension sends the URL of the current page to our server at <code>https://skillkit.sh/api/save-skill</code>. This is required to fetch and convert the webpage content into a skill file.</li>
<li><strong>What data is NOT sent:</strong> We do not send page content, browsing history, personal information, cookies, authentication tokens, or any data beyond the single URL you choose to save.</li>
<li><strong>No data stored on server:</strong> The URL is processed in real time to extract content, generate tags, and build the skill file. No URLs, page content, or user data are stored, logged, or retained on the server after the response is returned.</li>
<li><strong>Selection saves are local:</strong> When you save selected text via the right-click menu, the skill file is built entirely in the browser with no network requests.</li>
@@ -55,10 +55,10 @@
<p>The SkillKit MCP server runs locally and provides skill discovery over the Model Context Protocol. It loads skill data from a bundled JSON file and does not make external network requests or collect user data.</p>
<h2>Website</h2>
<p>The SkillKit website (<a href="https://agenstskills.com">agenstskills.com</a>) is a static site hosted on Vercel. We do not use cookies, analytics trackers, or collect personal information. Vercel may collect standard web server logs (IP address, user agent) as described in their <a href="https://vercel.com/legal/privacy-policy">privacy policy</a>.</p>
<p>The SkillKit website is available at <a href="https://skillkit.sh">skillkit.sh</a> and <a href="https://agenstskills.com">agenstskills.com</a>. It is a static site hosted on Vercel. We do not use cookies, analytics trackers, or collect personal information. Vercel may collect standard web server logs (IP address, user agent) as described in their <a href="https://vercel.com/legal/privacy-policy">privacy policy</a>.</p>
<h2>Third-Party Services</h2>
<p>The Chrome extension communicates with <code>agenstskills.com</code> (our own server, hosted on Vercel) to process webpage URLs. No third-party data processors, advertising networks, or analytics services are used.</p>
<p>The Chrome extension communicates with <code>skillkit.sh</code> and <code>agenstskills.com</code> (both our own servers, hosted on Vercel) to process webpage URLs. No third-party data processors, advertising networks, or analytics services are used.</p>
<h2>Data Retention</h2>
<p>We do not retain any user data. URLs sent to the API are processed in memory and discarded immediately after the response.</p>
Binary file not shown.
+1
View File
@@ -1,4 +1,5 @@
{
"ignoreCommand": "git diff --quiet HEAD^ HEAD -- .",
"buildCommand": "npm run build",
"outputDirectory": "dist",
"installCommand": "npm install",
+6 -6
View File
@@ -536,28 +536,28 @@
]
},
{
"id": "composioHQ/awesome-claude-code-skills/python-best-practices",
"id": "composioHQ/awesome-claude-skills/python-best-practices",
"name": "Python Best Practices",
"description": "Python coding standards and patterns",
"source": "composioHQ/awesome-claude-code-skills",
"source": "composioHQ/awesome-claude-skills",
"tags": [
"python"
]
},
{
"id": "composioHQ/awesome-claude-code-skills/rust-patterns",
"id": "composioHQ/awesome-claude-skills/rust-patterns",
"name": "Rust Patterns",
"description": "Rust memory safety and performance patterns",
"source": "composioHQ/awesome-claude-code-skills",
"source": "composioHQ/awesome-claude-skills",
"tags": [
"rust"
]
},
{
"id": "composioHQ/awesome-claude-code-skills/go-patterns",
"id": "composioHQ/awesome-claude-skills/go-patterns",
"name": "Go Patterns",
"description": "Go concurrency and idiomatic patterns",
"source": "composioHQ/awesome-claude-code-skills",
"source": "composioHQ/awesome-claude-skills",
"tags": [
"golang",
"go"
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.19.0",
"version": "1.19.2",
"private": true,
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/agents",
"version": "1.19.0",
"version": "1.19.2",
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/api",
"version": "1.19.0",
"version": "1.19.2",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+20 -7
View File
@@ -1,4 +1,4 @@
import type { Context, Next } from 'hono';
import type { Context, Next } from "hono";
interface RateLimitEntry {
count: number;
@@ -18,8 +18,12 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
}, windowMs).unref();
return async (c: Context, next: Next): Promise<Response | void> => {
const forwardedFor = c.req.header('x-forwarded-for');
const ip = (forwardedFor?.split(',')[0]?.trim()) || c.req.header('x-real-ip') || 'unknown';
const xRealIp = c.req.header("x-real-ip");
const forwarded = c.req.header("x-forwarded-for");
const forwardedIp = forwarded
? forwarded.split(",").at(-1)?.trim()
: undefined;
const ip = xRealIp || forwardedIp || "unknown";
const now = Date.now();
let entry = windows.get(ip);
@@ -30,12 +34,21 @@ export function rateLimiter(maxRequests = 60, windowMs = 60_000) {
entry.count++;
c.header('X-RateLimit-Limit', String(maxRequests));
c.header('X-RateLimit-Remaining', String(Math.max(0, maxRequests - entry.count)));
c.header('X-RateLimit-Reset', String(Math.ceil(entry.resetAt / 1000)));
c.header("X-RateLimit-Limit", String(maxRequests));
c.header(
"X-RateLimit-Remaining",
String(Math.max(0, maxRequests - entry.count)),
);
c.header("X-RateLimit-Reset", String(Math.ceil(entry.resetAt / 1000)));
if (entry.count > maxRequests) {
return c.json({ error: 'Too many requests', retryAfter: Math.ceil((entry.resetAt - now) / 1000) }, 429);
return c.json(
{
error: "Too many requests",
retryAfter: Math.ceil((entry.resetAt - now) / 1000),
},
429,
);
}
await next();
+50 -19
View File
@@ -1,5 +1,5 @@
import { Hono } from 'hono';
import { ContentExtractor, SkillGenerator, AutoTagger } from '@skillkit/core';
import { Hono } from "hono";
import { ContentExtractor, SkillGenerator, AutoTagger } from "@skillkit/core";
interface SaveRequest {
url?: string;
@@ -10,25 +10,40 @@ interface SaveRequest {
const MAX_TEXT_LENGTH = 500_000;
const BLOCKED_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);
const BLOCKED_HOSTS = new Set([
"localhost",
"127.0.0.1",
"[::1]",
"::1",
"0.0.0.0",
]);
function isAllowedUrl(url: string): boolean {
try {
const parsed = new URL(url);
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return false;
if (parsed.protocol !== "http:" && parsed.protocol !== "https:")
return false;
const hostname = parsed.hostname.toLowerCase();
const bare = hostname.replace(/^\[|\]$/g, '');
const bare = hostname.replace(/^\[|\]$/g, "");
if (BLOCKED_HOSTS.has(hostname) || BLOCKED_HOSTS.has(bare)) return false;
if (bare.startsWith('::ffff:')) return isAllowedUrl(`http://${bare.slice(7)}`);
if (bare.startsWith("::ffff:"))
return isAllowedUrl(`http://${bare.slice(7)}`);
if (/^127\./.test(bare) || /^0\./.test(bare)) return false;
if (bare.startsWith('10.') || bare.startsWith('192.168.')) return false;
if (bare.startsWith("10.") || bare.startsWith("192.168.")) return false;
if (/^172\.(1[6-9]|2\d|3[01])\./.test(bare)) return false;
if (bare.startsWith('169.254.')) return false;
if (bare.startsWith('fe80:') || bare.startsWith('fc') || bare.startsWith('fd')) return false;
if (bare.startsWith("169.254.")) return false;
if (bare.includes(":")) {
if (
bare.startsWith("fe80:") ||
bare.startsWith("fc") ||
bare.startsWith("fd")
)
return false;
if (bare.startsWith("ff")) return false;
}
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
if (bare.startsWith('ff')) return false;
return true;
} catch {
return false;
@@ -41,12 +56,12 @@ export function saveRoutes() {
const generator = new SkillGenerator();
const tagger = new AutoTagger();
app.post('/save', async (c) => {
app.post("/save", async (c) => {
let body: SaveRequest;
try {
body = await c.req.json();
} catch {
return c.json({ error: 'Invalid JSON body' }, 400);
return c.json({ error: "Invalid JSON body" }, 400);
}
if (!body.url && !body.text) {
@@ -54,11 +69,26 @@ export function saveRoutes() {
}
if (body.url && !isAllowedUrl(body.url)) {
return c.json({ error: 'URL must be a public HTTP(S) address' }, 400);
return c.json({ error: "URL must be a public HTTP(S) address" }, 400);
}
if (body.name && !/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/.test(body.name)) {
return c.json(
{
error:
"Name must be alphanumeric (hyphens, underscores, dots allowed)",
},
400,
);
}
if (body.text && body.text.length > MAX_TEXT_LENGTH) {
return c.json({ error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters` }, 400);
return c.json(
{
error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters`,
},
400,
);
}
try {
@@ -78,16 +108,17 @@ export function saveRoutes() {
tags: tagger.detectTags(content),
});
} catch (err) {
const message = err instanceof Error ? err.message : 'Unknown error';
console.error("Save extraction failed:", err);
const isTimeout =
(err instanceof DOMException && err.name === 'TimeoutError') ||
(err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError'));
(err instanceof DOMException && err.name === "TimeoutError") ||
(err instanceof Error &&
(err.name === "TimeoutError" || err.name === "AbortError"));
if (isTimeout) {
return c.json({ error: `Fetch timeout: ${message}` }, 504);
return c.json({ error: "Fetch timed out" }, 504);
}
return c.json({ error: `Extraction failed: ${message}` }, 422);
return c.json({ error: "Extraction failed" }, 422);
}
});
+33 -23
View File
@@ -1,15 +1,15 @@
import { Hono } from 'hono';
import { cors } from 'hono/cors';
import { MemoryCache } from '@skillkit/core';
import { rateLimiter } from './middleware/rate-limit.js';
import { healthRoutes } from './routes/health.js';
import { searchRoutes } from './routes/search.js';
import { skillRoutes } from './routes/skills.js';
import { trendingRoutes } from './routes/trending.js';
import { categoryRoutes } from './routes/categories.js';
import { docsRoutes } from './routes/docs.js';
import { saveRoutes } from './routes/save.js';
import type { ApiSkill, SearchResponse } from './types.js';
import { Hono } from "hono";
import { cors } from "hono/cors";
import { MemoryCache } from "@skillkit/core";
import { rateLimiter } from "./middleware/rate-limit.js";
import { healthRoutes } from "./routes/health.js";
import { searchRoutes } from "./routes/search.js";
import { skillRoutes } from "./routes/skills.js";
import { trendingRoutes } from "./routes/trending.js";
import { categoryRoutes } from "./routes/categories.js";
import { docsRoutes } from "./routes/docs.js";
import { saveRoutes } from "./routes/save.js";
import type { ApiSkill, SearchResponse } from "./types.js";
export interface ServerOptions {
port?: number;
@@ -29,26 +29,36 @@ export function createApp(options: ServerOptions = {}) {
const app = new Hono();
app.use('*', cors({ origin: options.corsOrigin || '*' }));
app.use('*', rateLimiter(options.rateLimitMax ?? 60));
app.use("*", cors({ origin: options.corsOrigin || "*" }));
app.use("*", async (c, next) => {
await next();
c.header("X-Content-Type-Options", "nosniff");
c.header("X-Frame-Options", "DENY");
c.header(
"Content-Security-Policy",
"default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'",
);
c.header("Referrer-Policy", "strict-origin-when-cross-origin");
});
app.use("*", rateLimiter(options.rateLimitMax ?? 60));
app.route('/', healthRoutes(skills.length, cache));
app.route('/', searchRoutes(skills, cache));
app.route('/', skillRoutes(skills));
app.route('/', trendingRoutes(skills));
app.route('/', categoryRoutes(skills));
app.route('/', docsRoutes());
app.route('/', saveRoutes());
app.route("/", healthRoutes(skills.length, cache));
app.route("/", searchRoutes(skills, cache));
app.route("/", skillRoutes(skills));
app.route("/", trendingRoutes(skills));
app.route("/", categoryRoutes(skills));
app.route("/", docsRoutes());
app.route("/", saveRoutes());
return { app, cache };
}
export async function startServer(options: ServerOptions = {}) {
const port = options.port ?? 3737;
const host = options.host ?? '0.0.0.0';
const host = options.host ?? "127.0.0.1";
const { app, cache } = createApp(options);
const { serve } = await import('@hono/node-server');
const { serve } = await import("@hono/node-server");
const server = serve({ fetch: app.fetch, port, hostname: host }, () => {
console.log(`SkillKit API server running at http://${host}:${port}`);
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.19.0",
"version": "1.19.2",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
+4 -4
View File
@@ -16,8 +16,8 @@ export function generateBadge(skills: string[]): {
const url = `https://img.shields.io/badge/SkillKit-No%20Skills-555555?style=flat-square&logo=data:image/svg+xml;base64,${SKILLKIT_LOGO_SVG_BASE64}`;
return {
url,
markdown: `[![SkillKit Stack](${url})](https://agenstskills.com)`,
html: `<a href="https://agenstskills.com"><img src="${url}" alt="SkillKit Stack" /></a>`,
markdown: `[![SkillKit Stack](${url})](https://skillkit.sh)`,
html: `<a href="https://skillkit.sh"><img src="${url}" alt="SkillKit Stack" /></a>`,
};
}
@@ -33,7 +33,7 @@ export function generateBadge(skills: string[]): {
return {
url,
markdown: `[![SkillKit Stack](${url})](https://agenstskills.com)`,
html: `<a href="https://agenstskills.com"><img src="${url}" alt="SkillKit Stack" /></a>`,
markdown: `[![SkillKit Stack](${url})](https://skillkit.sh)`,
html: `<a href="https://skillkit.sh"><img src="${url}" alt="SkillKit Stack" /></a>`,
};
}
+55
View File
@@ -0,0 +1,55 @@
import { Command, Option } from 'clipanion';
import { writeFileSync } from 'node:fs';
import chalk from 'chalk';
import { SessionHandoff } from '@skillkit/core';
export class SessionHandoffCommand extends Command {
static override paths = [['session', 'handoff']];
static override usage = Command.Usage({
description: 'Generate agent-to-agent session handoff document',
examples: [
['Print handoff to stdout', '$0 session handoff'],
['Target agent recommendations', '$0 session handoff --to cursor'],
['Save to file', '$0 session handoff --out handoff.md'],
['JSON output', '$0 session handoff --json'],
],
});
to = Option.String('--to', {
description: 'Target agent for recommendations',
});
out = Option.String('--out,-o', {
description: 'Save handoff to file',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const projectPath = process.cwd();
const handoff = new SessionHandoff(projectPath);
const doc = handoff.generate({
targetAgent: this.to,
});
const output = this.json ? handoff.toJson(doc) : handoff.toMarkdown(doc);
if (this.out) {
try {
writeFileSync(this.out, output, 'utf-8');
console.log(chalk.green(`Handoff saved to ${this.out}`));
} catch (error) {
console.error(chalk.red(`Failed to write file: ${(error as Error).message}`));
return 1;
}
} else {
console.log(output);
}
return 0;
}
}
+3
View File
@@ -127,6 +127,9 @@ export { ServeCommand } from './serve.js';
export { ScanCommand } from './scan.js';
export { IssuePlanCommand, IssueListCommand } from './issue.js';
export { DoctorCommand } from './doctor.js';
export { TimelineCommand } from './timeline.js';
export { SessionHandoffCommand } from './handoff.js';
export { LineageCommand } from './lineage.js';
export { SaveCommand } from './save.js';
export {
AgentsMdCommand,
+66
View File
@@ -0,0 +1,66 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { SkillLineage } from '@skillkit/core';
export class LineageCommand extends Command {
static override paths = [['lineage']];
static override usage = Command.Usage({
description: 'Show skill impact lineage — which skills produced which changes',
examples: [
['Full overview', '$0 lineage'],
['Single skill', '$0 lineage --skill code-simplifier'],
['Single file', '$0 lineage --file src/index.ts'],
['Date filter + JSON', '$0 lineage --since 2026-02-01 --json'],
],
});
skill = Option.String('--skill,-s', {
description: 'Filter by skill name',
});
file = Option.String('--file,-f', {
description: 'Filter by file path',
});
since = Option.String('--since', {
description: 'Show lineage since date (YYYY-MM-DD)',
});
limit = Option.String('--limit,-l', {
description: 'Max entries to show',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const projectPath = process.cwd();
const lineage = new SkillLineage(projectPath);
const parsed = this.limit ? parseInt(this.limit, 10) : undefined;
const limit = parsed && Number.isFinite(parsed) && parsed > 0 ? parsed : undefined;
const data = lineage.build({
skill: this.skill,
file: this.file,
since: this.since,
limit,
});
if (this.json) {
console.log(lineage.formatJson(data));
return 0;
}
if (data.skills.length === 0) {
console.log(chalk.yellow('No skill lineage found.'));
console.log(chalk.dim('Lineage is built from skill execution history and activity logs.'));
return 0;
}
console.log(lineage.formatText(data));
return 0;
}
}
+1 -1
View File
@@ -23,7 +23,7 @@ export class MarketplaceCommand extends Command {
from curated repositories.
Skills are aggregated from multiple sources including:
- composioHQ/awesome-claude-code-skills
- composioHQ/awesome-claude-skills
- anthropics/courses
- User-added custom sources
`,
+302 -222
View File
@@ -1,13 +1,31 @@
import { existsSync, readFileSync, mkdirSync, writeFileSync, readdirSync, statSync } from 'node:fs';
import { join, basename, dirname, resolve } from 'node:path';
import chalk from 'chalk';
import { Command, Option } from 'clipanion';
import { generateWellKnownIndex, type WellKnownSkill, SkillScanner, formatSummary, Severity } from '@skillkit/core';
import {
existsSync,
readFileSync,
mkdirSync,
writeFileSync,
readdirSync,
statSync,
} from "node:fs";
import { join, basename, dirname, resolve, sep } from "node:path";
import chalk from "chalk";
import { Command, Option } from "clipanion";
import {
generateWellKnownIndex,
type WellKnownSkill,
SkillScanner,
formatSummary,
Severity,
} from "@skillkit/core";
function sanitizeSkillName(name: string): string | null {
if (!name || typeof name !== 'string') return null;
if (!name || typeof name !== "string") return null;
const base = basename(name);
if (base !== name || name.includes('..') || name.includes('/') || name.includes('\\')) {
if (
base !== name ||
name.includes("..") ||
name.includes("/") ||
name.includes("\\")
) {
return null;
}
if (!/^[a-zA-Z0-9._-]+$/.test(name)) {
@@ -23,11 +41,64 @@ interface SkillFrontmatter {
version?: string;
}
function parseSkillFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
let inTagsList = false;
for (const line of lines) {
if (inTagsList) {
const tagMatch = line.match(/^\s*-\s*(.+)$/);
if (tagMatch) {
frontmatter.tags ??= [];
frontmatter.tags.push(tagMatch[1].trim().replace(/^["']|["']$/g, ""));
continue;
}
if (line.trim() === "") continue;
inTagsList = false;
}
const colonIdx = line.indexOf(":");
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case "name":
frontmatter.name = value.replace(/^["']|["']$/g, "");
break;
case "description":
frontmatter.description = value.replace(/^["']|["']$/g, "");
break;
case "version":
frontmatter.version = value.replace(/^["']|["']$/g, "");
break;
case "tags":
if (value.startsWith("[")) {
frontmatter.tags = value
.slice(1, -1)
.split(",")
.map((t) => t.trim().replace(/^["']|["']$/g, ""))
.filter((t) => t.length > 0);
} else if (value === "") {
inTagsList = true;
frontmatter.tags = [];
}
break;
}
}
return frontmatter;
}
export class PublishCommand extends Command {
static override paths = [['publish']];
static override paths = [["publish"]];
static override usage = Command.Usage({
description: 'Generate well-known skills structure for hosting',
description: "Generate well-known skills structure for hosting",
details: `
This command generates the RFC 8615 well-known URI structure for hosting skills.
@@ -38,59 +109,79 @@ export class PublishCommand extends Command {
Users can then install skills via: skillkit add https://your-domain.com
`,
examples: [
['Generate from current directory', '$0 publish'],
['Generate from specific path', '$0 publish ./my-skills'],
['Generate to custom output directory', '$0 publish --output ./public'],
['Preview without writing', '$0 publish --dry-run'],
["Generate from current directory", "$0 publish"],
["Generate from specific path", "$0 publish ./my-skills"],
["Generate to custom output directory", "$0 publish --output ./public"],
["Preview without writing", "$0 publish --dry-run"],
],
});
skillPath = Option.String({ required: false, name: 'path' });
skillPath = Option.String({ required: false, name: "path" });
output = Option.String('--output,-o', {
description: 'Output directory for well-known structure (default: current directory)',
output = Option.String("--output,-o", {
description:
"Output directory for well-known structure (default: current directory)",
});
dryRun = Option.Boolean('--dry-run,-n', false, {
description: 'Show what would be generated without writing files',
dryRun = Option.Boolean("--dry-run,-n", false, {
description: "Show what would be generated without writing files",
});
format = Option.String('--format', {
description: 'Output format: "standard" (default) or "mintlify" (.well-known/skills/default/skill.md)',
format = Option.String("--format", {
description:
'Output format: "standard" (default) or "mintlify" (.well-known/skills/default/skill.md)',
});
async execute(): Promise<number> {
const basePath = this.skillPath || process.cwd();
const outputDir = this.output || basePath;
console.log(chalk.cyan('Generating well-known skills structure...\n'));
console.log(chalk.cyan("Generating well-known skills structure...\n"));
const discoveredSkills = this.discoverSkills(basePath);
if (discoveredSkills.length === 0) {
console.error(chalk.red('No skills found'));
console.error(chalk.dim('Skills must contain a SKILL.md file with frontmatter'));
console.error(chalk.red("No skills found"));
console.error(
chalk.dim("Skills must contain a SKILL.md file with frontmatter"),
);
return 1;
}
console.log(chalk.white(`Found ${discoveredSkills.length} skill(s):\n`));
const wellKnownSkills: WellKnownSkill[] = [];
const validSkills: Array<{ name: string; safeName: string; description?: string; path: string }> = [];
const validSkills: Array<{
name: string;
safeName: string;
description?: string;
path: string;
}> = [];
for (const skill of discoveredSkills) {
const safeName = sanitizeSkillName(skill.name);
if (!safeName) {
console.log(chalk.yellow(` ${chalk.yellow('⚠')} Skipping "${skill.name}" (invalid name - must be alphanumeric with hyphens/underscores)`));
console.log(
chalk.yellow(
` ${chalk.yellow("⚠")} Skipping "${skill.name}" (invalid name - must be alphanumeric with hyphens/underscores)`,
),
);
continue;
}
const files = this.getSkillFiles(skill.path);
console.log(chalk.dim(` ${chalk.green('●')} ${safeName}`));
console.log(chalk.dim(` Description: ${skill.description || 'No description'}`));
console.log(chalk.dim(` Files: ${files.join(', ')}`));
console.log(chalk.dim(` ${chalk.green("●")} ${safeName}`));
console.log(
chalk.dim(` Description: ${skill.description || "No description"}`),
);
console.log(chalk.dim(` Files: ${files.join(", ")}`));
validSkills.push({ name: skill.name, safeName, description: skill.description, path: skill.path });
validSkills.push({
name: skill.name,
safeName,
description: skill.description,
path: skill.path,
});
wellKnownSkills.push({
name: safeName,
description: skill.description,
@@ -101,78 +192,115 @@ export class PublishCommand extends Command {
const scanner = new SkillScanner({ failOnSeverity: Severity.HIGH });
for (const skill of validSkills) {
const scanResult = await scanner.scan(skill.path);
if (scanResult.verdict === 'fail') {
console.error(chalk.red(`\nSecurity scan FAILED for "${skill.safeName}"`));
if (scanResult.verdict === "fail") {
console.error(
chalk.red(`\nSecurity scan FAILED for "${skill.safeName}"`),
);
console.error(formatSummary(scanResult));
console.error(chalk.dim('Fix security issues before publishing.'));
console.error(chalk.dim("Fix security issues before publishing."));
return 1;
}
if (scanResult.verdict === 'warn') {
console.log(chalk.yellow(` Security warnings for "${skill.safeName}" (${scanResult.findings.length} findings)`));
if (scanResult.verdict === "warn") {
console.log(
chalk.yellow(
` Security warnings for "${skill.safeName}" (${scanResult.findings.length} findings)`,
),
);
}
}
if (validSkills.length === 0) {
console.error(chalk.red('\nNo valid skills to publish'));
console.error(chalk.red("\nNo valid skills to publish"));
return 1;
}
console.log('');
console.log("");
if (this.format === 'mintlify') {
if (this.format === "mintlify") {
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not writing files\n'));
console.log(chalk.white('Would generate (Mintlify format):'));
console.log(chalk.yellow("Dry run - not writing files\n"));
console.log(chalk.white("Would generate (Mintlify format):"));
for (const skill of validSkills) {
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`));
console.log(
chalk.dim(
` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`,
),
);
}
return 0;
}
const resolvedOutput = resolve(outputDir);
for (const skill of validSkills) {
const mintlifyDir = join(outputDir, '.well-known', 'skills', skill.safeName);
const mintlifyDir = join(
outputDir,
".well-known",
"skills",
skill.safeName,
);
const resolvedDir = resolve(mintlifyDir);
if (!resolvedDir.startsWith(resolvedOutput)) {
console.log(chalk.red(`Skipping ${skill.safeName} (path traversal detected)`));
if (!resolvedDir.startsWith(resolvedOutput + sep)) {
console.log(
chalk.red(`Skipping ${skill.safeName} (path traversal detected)`),
);
continue;
}
mkdirSync(mintlifyDir, { recursive: true });
const skillMdPath = join(skill.path, 'SKILL.md');
const skillMdPath = join(skill.path, "SKILL.md");
if (existsSync(skillMdPath)) {
const content = readFileSync(skillMdPath, 'utf-8');
writeFileSync(join(mintlifyDir, 'skill.md'), content);
const content = readFileSync(skillMdPath, "utf-8");
writeFileSync(join(mintlifyDir, "skill.md"), content);
}
}
console.log(chalk.green('Generated Mintlify well-known structure:\n'));
console.log(chalk.green("Generated Mintlify well-known structure:\n"));
for (const skill of validSkills) {
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`));
console.log(
chalk.dim(
` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`,
),
);
}
console.log('');
console.log(chalk.cyan('Next steps:'));
console.log(chalk.dim(' 1. Deploy the .well-known directory to your web server'));
console.log(chalk.dim(' 2. Users can install via: skillkit install https://your-domain.com'));
console.log(chalk.dim(' 3. Skills auto-discovered from /.well-known/skills/{name}/skill.md'));
console.log("");
console.log(chalk.cyan("Next steps:"));
console.log(
chalk.dim(" 1. Deploy the .well-known directory to your web server"),
);
console.log(
chalk.dim(
" 2. Users can install via: skillkit install https://your-domain.com",
),
);
console.log(
chalk.dim(
" 3. Skills auto-discovered from /.well-known/skills/{name}/skill.md",
),
);
return 0;
}
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not writing files\n'));
console.log(chalk.white('Would generate:'));
console.log(chalk.yellow("Dry run - not writing files\n"));
console.log(chalk.white("Would generate:"));
console.log(chalk.dim(` ${outputDir}/.well-known/skills/index.json`));
for (const skill of wellKnownSkills) {
for (const file of skill.files) {
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.name}/${file}`));
console.log(
chalk.dim(
` ${outputDir}/.well-known/skills/${skill.name}/${file}`,
),
);
}
}
console.log('');
console.log(chalk.white('index.json preview:'));
console.log(JSON.stringify(generateWellKnownIndex(wellKnownSkills), null, 2));
console.log("");
console.log(chalk.white("index.json preview:"));
console.log(
JSON.stringify(generateWellKnownIndex(wellKnownSkills), null, 2),
);
return 0;
}
const wellKnownDir = join(outputDir, '.well-known', 'skills');
const wellKnownDir = join(outputDir, ".well-known", "skills");
mkdirSync(wellKnownDir, { recursive: true });
for (const skill of validSkills) {
@@ -180,8 +308,10 @@ export class PublishCommand extends Command {
const resolvedSkillDir = resolve(skillDir);
const resolvedWellKnownDir = resolve(wellKnownDir);
if (!resolvedSkillDir.startsWith(resolvedWellKnownDir)) {
console.log(chalk.yellow(` Skipping "${skill.name}" (path traversal detected)`));
if (!resolvedSkillDir.startsWith(resolvedWellKnownDir + sep)) {
console.log(
chalk.yellow(` Skipping "${skill.name}" (path traversal detected)`),
);
continue;
}
@@ -192,35 +322,51 @@ export class PublishCommand extends Command {
const safeFile = basename(file);
const sourcePath = join(skill.path, file);
const destPath = join(skillDir, safeFile);
const content = readFileSync(sourcePath, 'utf-8');
const content = readFileSync(sourcePath, "utf-8");
writeFileSync(destPath, content);
}
}
const index = generateWellKnownIndex(wellKnownSkills);
writeFileSync(join(wellKnownDir, 'index.json'), JSON.stringify(index, null, 2));
writeFileSync(
join(wellKnownDir, "index.json"),
JSON.stringify(index, null, 2),
);
console.log(chalk.green('Generated well-known structure:\n'));
console.log(chalk.green("Generated well-known structure:\n"));
console.log(chalk.dim(` ${wellKnownDir}/index.json`));
for (const skill of wellKnownSkills) {
console.log(chalk.dim(` ${wellKnownDir}/${skill.name}/`));
}
console.log('');
console.log(chalk.cyan('Next steps:'));
console.log(chalk.dim(' 1. Deploy the .well-known directory to your web server'));
console.log(chalk.dim(' 2. Users can install via: skillkit add https://your-domain.com'));
console.log(chalk.dim(' 3. Skills auto-discovered from /.well-known/skills/index.json'));
console.log("");
console.log(chalk.cyan("Next steps:"));
console.log(
chalk.dim(" 1. Deploy the .well-known directory to your web server"),
);
console.log(
chalk.dim(
" 2. Users can install via: skillkit add https://your-domain.com",
),
);
console.log(
chalk.dim(
" 3. Skills auto-discovered from /.well-known/skills/index.json",
),
);
return 0;
}
private discoverSkills(basePath: string): Array<{ name: string; description?: string; path: string }> {
const skills: Array<{ name: string; description?: string; path: string }> = [];
private discoverSkills(
basePath: string,
): Array<{ name: string; description?: string; path: string }> {
const skills: Array<{ name: string; description?: string; path: string }> =
[];
const skillMdPath = join(basePath, 'SKILL.md');
const skillMdPath = join(basePath, "SKILL.md");
if (existsSync(skillMdPath)) {
const content = readFileSync(skillMdPath, 'utf-8');
const content = readFileSync(skillMdPath, "utf-8");
const frontmatter = this.parseFrontmatter(content);
skills.push({
name: frontmatter.name || basename(basePath),
@@ -232,8 +378,8 @@ export class PublishCommand extends Command {
const searchDirs = [
basePath,
join(basePath, 'skills'),
join(basePath, '.claude', 'skills'),
join(basePath, "skills"),
join(basePath, ".claude", "skills"),
];
for (const searchDir of searchDirs) {
@@ -244,9 +390,9 @@ export class PublishCommand extends Command {
const entryPath = join(searchDir, entry);
if (!statSync(entryPath).isDirectory()) continue;
const entrySkillMd = join(entryPath, 'SKILL.md');
const entrySkillMd = join(entryPath, "SKILL.md");
if (existsSync(entrySkillMd)) {
const content = readFileSync(entrySkillMd, 'utf-8');
const content = readFileSync(entrySkillMd, "utf-8");
const frontmatter = this.parseFrontmatter(content);
skills.push({
name: frontmatter.name || entry,
@@ -267,92 +413,42 @@ export class PublishCommand extends Command {
for (const entry of entries) {
const entryPath = join(skillPath, entry);
if (statSync(entryPath).isFile()) {
if (entry.startsWith('.') || entry === '.skillkit-metadata.json') continue;
if (entry.startsWith(".")) continue;
files.push(entry);
}
}
if (!files.includes('SKILL.md')) {
files.unshift('SKILL.md');
if (!files.includes("SKILL.md")) {
files.unshift("SKILL.md");
}
return files;
}
private parseFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
let inTagsList = false;
for (const line of lines) {
if (inTagsList) {
const tagMatch = line.match(/^\s*-\s*(.+)$/);
if (tagMatch) {
frontmatter.tags ??= [];
frontmatter.tags.push(tagMatch[1].trim().replace(/^["']|["']$/g, ''));
continue;
}
if (line.trim() === '') continue;
inTagsList = false;
}
const colonIdx = line.indexOf(':');
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case 'name':
frontmatter.name = value.replace(/^["']|["']$/g, '');
break;
case 'description':
frontmatter.description = value.replace(/^["']|["']$/g, '');
break;
case 'version':
frontmatter.version = value.replace(/^["']|["']$/g, '');
break;
case 'tags':
if (value.startsWith('[')) {
frontmatter.tags = value
.slice(1, -1)
.split(',')
.map(t => t.trim().replace(/^["']|["']$/g, ''))
.filter(t => t.length > 0);
} else if (value === '') {
inTagsList = true;
frontmatter.tags = [];
}
break;
}
}
return frontmatter;
return parseSkillFrontmatter(content);
}
}
export class PublishSubmitCommand extends Command {
static override paths = [['publish', 'submit']];
static override paths = [["publish", "submit"]];
static override usage = Command.Usage({
description: 'Submit skill to SkillKit marketplace (requires review)',
description: "Submit skill to SkillKit marketplace (requires review)",
examples: [
['Submit skill from current directory', '$0 publish submit'],
['Submit with custom name', '$0 publish submit --name my-skill'],
["Submit skill from current directory", "$0 publish submit"],
["Submit with custom name", "$0 publish submit --name my-skill"],
],
});
skillPath = Option.String({ required: false, name: 'path' });
skillPath = Option.String({ required: false, name: "path" });
name = Option.String('--name,-n', {
description: 'Custom skill name',
name = Option.String("--name,-n", {
description: "Custom skill name",
});
dryRun = Option.Boolean('--dry-run', false, {
description: 'Show what would be submitted',
dryRun = Option.Boolean("--dry-run", false, {
description: "Show what would be submitted",
});
async execute(): Promise<number> {
@@ -360,49 +456,58 @@ export class PublishSubmitCommand extends Command {
const skillMdPath = this.findSkillMd(skillPath);
if (!skillMdPath) {
console.error(chalk.red('No SKILL.md found'));
console.error(chalk.dim('Run this command from a directory containing SKILL.md'));
console.error(chalk.red("No SKILL.md found"));
console.error(
chalk.dim("Run this command from a directory containing SKILL.md"),
);
return 1;
}
console.log(chalk.cyan('Submitting skill to SkillKit marketplace...\n'));
console.log(chalk.cyan("Submitting skill to SkillKit marketplace...\n"));
const content = readFileSync(skillMdPath, 'utf-8');
const content = readFileSync(skillMdPath, "utf-8");
const frontmatter = this.parseFrontmatter(content);
const skillName = this.name || frontmatter.name || basename(dirname(skillMdPath));
const skillName =
this.name || frontmatter.name || basename(dirname(skillMdPath));
const repoInfo = this.getRepoInfo(dirname(skillMdPath));
const repoInfo = await this.getRepoInfo(dirname(skillMdPath));
if (!repoInfo) {
console.error(chalk.red('Not a git repository or no remote configured'));
console.error(chalk.dim('Your skill must be in a git repository with a GitHub remote'));
console.error(chalk.red("Not a git repository or no remote configured"));
console.error(
chalk.dim(
"Your skill must be in a git repository with a GitHub remote",
),
);
return 1;
}
const skillSlug = this.slugify(skillName);
if (!skillSlug) {
console.error(chalk.red('Skill name produces an empty slug.'));
console.error(chalk.dim('Please pass --name with letters or numbers.'));
console.error(chalk.red("Skill name produces an empty slug."));
console.error(chalk.dim("Please pass --name with letters or numbers."));
return 1;
}
const skillEntry = {
id: `${repoInfo.owner}/${repoInfo.repo}/${skillSlug}`,
name: this.formatName(skillName),
description: frontmatter.description || `Best practices for ${this.formatName(skillName)}`,
description:
frontmatter.description ||
`Best practices for ${this.formatName(skillName)}`,
source: `${repoInfo.owner}/${repoInfo.repo}`,
tags: frontmatter.tags || ['general'],
tags: frontmatter.tags || ["general"],
};
console.log(chalk.white('Skill details:'));
console.log(chalk.white("Skill details:"));
console.log(chalk.dim(` ID: ${skillEntry.id}`));
console.log(chalk.dim(` Name: ${skillEntry.name}`));
console.log(chalk.dim(` Description: ${skillEntry.description}`));
console.log(chalk.dim(` Source: ${skillEntry.source}`));
console.log(chalk.dim(` Tags: ${skillEntry.tags.join(', ')}`));
console.log(chalk.dim(` Tags: ${skillEntry.tags.join(", ")}`));
console.log();
if (this.dryRun) {
console.log(chalk.yellow('Dry run - not submitting'));
console.log(chalk.yellow("Dry run - not submitting"));
console.log(JSON.stringify(skillEntry, null, 2));
return 0;
}
@@ -412,23 +517,27 @@ export class PublishSubmitCommand extends Command {
const issueBodyEncoded = encodeURIComponent(issueBody);
const issueUrl = `https://github.com/rohitg00/skillkit/issues/new?title=${issueTitle}&body=${issueBodyEncoded}&labels=skill-submission,publish`;
console.log(chalk.green('Opening GitHub to submit your skill...\n'));
console.log(chalk.green("Opening GitHub to submit your skill...\n"));
try {
const { execSync } = await import('node:child_process');
const openCmd =
process.platform === 'darwin'
? `open "${issueUrl}"`
: process.platform === 'win32'
? `cmd /c start "" "${issueUrl}"`
: `xdg-open "${issueUrl}"`;
execSync(openCmd, { stdio: 'ignore' });
const { execFileSync } = await import("node:child_process");
const cmd =
process.platform === "darwin"
? "open"
: process.platform === "win32"
? "cmd"
: "xdg-open";
const args =
process.platform === "win32"
? ["/c", "start", "", issueUrl]
: [issueUrl];
execFileSync(cmd, args, { stdio: "ignore" });
console.log(chalk.green('GitHub issue page opened!'));
console.log(chalk.dim('Review and submit the issue.'));
console.log(chalk.green("GitHub issue page opened!"));
console.log(chalk.dim("Review and submit the issue."));
} catch {
console.log(chalk.yellow('Could not open browser automatically.'));
console.log(chalk.dim('Please open this URL manually:\n'));
console.log(chalk.yellow("Could not open browser automatically."));
console.log(chalk.dim("Please open this URL manually:\n"));
console.log(chalk.cyan(issueUrl));
}
@@ -436,18 +545,18 @@ export class PublishSubmitCommand extends Command {
}
private findSkillMd(basePath: string): string | null {
if (basePath.endsWith('SKILL.md') && existsSync(basePath)) {
if (basePath.endsWith("SKILL.md") && existsSync(basePath)) {
return basePath;
}
const direct = join(basePath, 'SKILL.md');
const direct = join(basePath, "SKILL.md");
if (existsSync(direct)) {
return direct;
}
const locations = [
join(basePath, 'skills', 'SKILL.md'),
join(basePath, '.claude', 'skills', 'SKILL.md'),
join(basePath, "skills", "SKILL.md"),
join(basePath, ".claude", "skills", "SKILL.md"),
];
for (const loc of locations) {
@@ -460,59 +569,26 @@ export class PublishSubmitCommand extends Command {
}
private parseFrontmatter(content: string): SkillFrontmatter {
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (!match) return {};
const frontmatter: SkillFrontmatter = {};
const lines = match[1].split(/\r?\n/);
for (const line of lines) {
const colonIdx = line.indexOf(':');
if (colonIdx === -1) continue;
const key = line.slice(0, colonIdx).trim();
const value = line.slice(colonIdx + 1).trim();
switch (key) {
case 'name':
frontmatter.name = value.replace(/^["']|["']$/g, '');
break;
case 'description':
frontmatter.description = value.replace(/^["']|["']$/g, '');
break;
case 'version':
frontmatter.version = value.replace(/^["']|["']$/g, '');
break;
case 'tags':
if (value.startsWith('[')) {
frontmatter.tags = value
.slice(1, -1)
.split(',')
.map(t => t.trim().replace(/^["']|["']$/g, ''))
.filter(t => t.length > 0);
}
break;
}
}
return frontmatter;
return parseSkillFrontmatter(content);
}
private slugify(name: string): string {
return name
.toLowerCase()
.trim()
.replace(/[^a-z0-9]+/g, '-')
.replace(/^-+|-+$/g, '');
.replace(/[^a-z0-9]+/g, "-")
.replace(/^-+|-+$/g, "");
}
private getRepoInfo(dir: string): { owner: string; repo: string } | null {
private async getRepoInfo(
dir: string,
): Promise<{ owner: string; repo: string } | null> {
try {
const { execSync } = require('node:child_process');
const remote = execSync('git remote get-url origin', {
const { execFileSync } = await import("node:child_process");
const remote = execFileSync("git", ["remote", "get-url", "origin"], {
cwd: dir,
encoding: 'utf-8',
stdio: ['pipe', 'pipe', 'ignore'],
encoding: "utf-8",
stdio: ["pipe", "pipe", "ignore"],
}).trim();
const match = remote.match(/github\.com[:/]([^/]+)\/(.+?)(?:\.git)?$/);
@@ -529,13 +605,17 @@ export class PublishSubmitCommand extends Command {
private formatName(name: string): string {
return name
.split(/[-_]/)
.map(word => word.charAt(0).toUpperCase() + word.slice(1))
.join(' ');
.map((word) => word.charAt(0).toUpperCase() + word.slice(1))
.join(" ");
}
private createIssueBody(
skill: { id: string; name: string; description: string; source: string; tags: string[] }
): string {
private createIssueBody(skill: {
id: string;
name: string;
description: string;
source: string;
tags: string[];
}): string {
return `## Publish Skill Request
### Skill Details
@@ -543,7 +623,7 @@ export class PublishSubmitCommand extends Command {
- **Name:** ${skill.name}
- **Description:** ${skill.description}
- **Source:** [${skill.source}](https://github.com/${skill.source})
- **Tags:** ${skill.tags.map(t => `\`${t}\``).join(', ')}
- **Tags:** ${skill.tags.map((t) => `\`${t}\``).join(", ")}
### JSON Entry
\`\`\`json
+1 -1
View File
@@ -351,7 +351,7 @@ export class QuickCommand extends Command {
console.log('');
const badgeUrl = `https://img.shields.io/badge/SkillKit-${encodeURIComponent(matchedSkill.name)}-black?style=flat-square`;
console.log(colors.dim('Add to your README:'));
console.log(colors.muted(` [![SkillKit](${badgeUrl})](https://agenstskills.com)`));
console.log(colors.muted(` [![SkillKit](${badgeUrl})](https://skillkit.sh)`));
outro('Quick setup complete!');
+83
View File
@@ -0,0 +1,83 @@
import { Command, Option } from 'clipanion';
import chalk from 'chalk';
import { SessionTimeline } from '@skillkit/core';
import type { TimelineEventType } from '@skillkit/core';
export class TimelineCommand extends Command {
static override paths = [['timeline']];
static override usage = Command.Usage({
description: 'Show unified session event timeline',
examples: [
['Show last 50 events', '$0 timeline'],
['Filter by type', '$0 timeline --type git_commit'],
['Filter by skill', '$0 timeline --skill code-simplifier'],
['Date filter', '$0 timeline --since 2026-02-10'],
['JSON output with limit', '$0 timeline --limit 20 --json'],
],
});
type = Option.String('--type,-t', {
description: 'Filter by event type (skill_start, skill_complete, task_progress, git_commit, observation, decision, snapshot)',
});
skill = Option.String('--skill,-s', {
description: 'Filter by skill name',
});
since = Option.String('--since', {
description: 'Show events since date (YYYY-MM-DD)',
});
limit = Option.String('--limit,-l', {
description: 'Max events to show (default: 50)',
});
json = Option.Boolean('--json,-j', false, {
description: 'Output as JSON',
});
async execute(): Promise<number> {
const projectPath = process.cwd();
const timeline = new SessionTimeline(projectPath);
const parsed = this.limit ? parseInt(this.limit, 10) : 50;
const limit = Number.isFinite(parsed) && parsed > 0 ? parsed : 50;
const validTypes: TimelineEventType[] = [
'skill_start', 'skill_complete', 'task_progress',
'git_commit', 'observation', 'decision', 'snapshot',
];
let types: TimelineEventType[] | undefined;
if (this.type) {
if (!validTypes.includes(this.type as TimelineEventType)) {
console.log(chalk.red(`Invalid event type: ${this.type}`));
console.log(chalk.dim(`Valid types: ${validTypes.join(', ')}`));
return 1;
}
types = [this.type as TimelineEventType];
}
const data = timeline.build({
since: this.since,
types,
limit,
skillFilter: this.skill,
});
if (this.json) {
console.log(timeline.formatJson(data));
return 0;
}
if (data.events.length === 0) {
console.log(chalk.yellow('No timeline events found.'));
console.log(chalk.dim('Events are recorded during skill execution, git commits, and observations.'));
return 0;
}
console.log(timeline.formatText(data));
return 0;
}
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/core",
"version": "1.19.0",
"version": "1.19.2",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
+109 -74
View File
@@ -4,8 +4,9 @@
* Executes skills with task-based orchestration, verification, and state management.
*/
import { execSync } from 'node:child_process';
import { randomUUID } from 'node:crypto';
import { execFileSync } from "node:child_process";
import { randomUUID } from "node:crypto";
import { splitCommand } from "../utils/shell.js";
import type {
ExecutableSkill,
ExecutableTask,
@@ -15,20 +16,25 @@ import type {
CheckpointHandler,
CheckpointResponse,
ExecutionTaskStatus,
} from './types.js';
import { SessionManager } from '../session/manager.js';
import type { SessionTask } from '../session/types.js';
} from "./types.js";
import { SessionManager } from "../session/manager.js";
import type { SessionTask } from "../session/types.js";
/**
* Progress event for execution
*/
export interface ExecutionProgressEvent {
type: 'task_start' | 'task_complete' | 'checkpoint' | 'verification' | 'complete';
type:
| "task_start"
| "task_complete"
| "checkpoint"
| "verification"
| "complete";
taskId?: string;
taskName?: string;
taskIndex?: number;
totalTasks?: number;
status?: ExecutionTaskStatus | 'paused' | 'cancelled';
status?: ExecutionTaskStatus | "paused" | "cancelled";
message?: string;
error?: string;
}
@@ -52,7 +58,7 @@ export class SkillExecutionEngine {
options?: {
checkpointHandler?: CheckpointHandler;
onProgress?: ExecutionProgressCallback;
}
},
) {
this.projectPath = projectPath;
this.sessionManager = new SessionManager(projectPath);
@@ -65,7 +71,7 @@ export class SkillExecutionEngine {
*/
async execute(
skill: ExecutableSkill,
options: ExecutionOptions = {}
options: ExecutionOptions = {},
): Promise<SkillExecutionResult> {
const startTime = new Date();
const tasks = skill.tasks || [];
@@ -78,23 +84,26 @@ export class SkillExecutionEngine {
// Check if there's an existing paused execution for this skill
const existingState = this.sessionManager.get();
if (existingState?.currentExecution?.skillName === skill.name) {
if (existingState.currentExecution.status === 'paused') {
if (existingState.currentExecution.status === "paused") {
// Resume from paused state
return this.resumeExecution(skill, options);
}
}
// Start new execution
const sessionTasks: Omit<SessionTask, 'status'>[] = tasks.map((task, index) => ({
id: task.id || `task-${index}`,
name: task.name,
type: task.type === 'auto' ? 'auto' : task.type,
}));
const sessionTasks: Omit<SessionTask, "status">[] = tasks.map(
(task, index) => ({
id: task.id || `task-${index}`,
name: task.name,
type: task.type === "auto" ? "auto" : task.type,
}),
);
this.sessionManager.startExecution(skill.name, skill.source, sessionTasks);
const taskResults: TaskExecutionResult[] = [];
let overallStatus: 'completed' | 'failed' | 'cancelled' | 'paused' = 'completed';
let overallStatus: "completed" | "failed" | "cancelled" | "paused" =
"completed";
let overallError: string | undefined;
// Execute tasks
@@ -102,7 +111,7 @@ export class SkillExecutionEngine {
const task = tasks[i];
this.onProgress?.({
type: 'task_start',
type: "task_start",
taskId: task.id,
taskName: task.name,
taskIndex: i,
@@ -110,7 +119,7 @@ export class SkillExecutionEngine {
});
// Handle checkpoints
if (task.type !== 'auto') {
if (task.type !== "auto") {
const checkpointResult = await this.handleCheckpoint(task, {
skillName: skill.name,
taskIndex: i,
@@ -118,17 +127,20 @@ export class SkillExecutionEngine {
});
if (!checkpointResult.continue) {
overallStatus = 'paused';
overallStatus = "paused";
this.sessionManager.pause();
break;
}
// For decision checkpoints, record the decision
if (task.type === 'checkpoint:decision' && checkpointResult.selectedOption) {
if (
task.type === "checkpoint:decision" &&
checkpointResult.selectedOption
) {
this.sessionManager.recordDecision(
`${skill.name}:${task.id}`,
checkpointResult.selectedOption,
skill.name
skill.name,
);
}
}
@@ -138,7 +150,7 @@ export class SkillExecutionEngine {
taskResults.push(taskResult);
this.sessionManager.updateTask(task.id || `task-${i}`, {
status: taskResult.status === 'completed' ? 'completed' : 'failed',
status: taskResult.status === "completed" ? "completed" : "failed",
output: taskResult.output,
error: taskResult.error,
filesModified: taskResult.filesModified,
@@ -146,7 +158,7 @@ export class SkillExecutionEngine {
});
this.onProgress?.({
type: 'task_complete',
type: "task_complete",
taskId: task.id,
taskName: task.name,
taskIndex: i,
@@ -156,9 +168,9 @@ export class SkillExecutionEngine {
});
// Handle task failure
if (taskResult.status === 'failed') {
if (taskResult.status === "failed") {
if (!options.continueOnError) {
overallStatus = 'failed';
overallStatus = "failed";
overallError = taskResult.error;
break;
}
@@ -168,8 +180,8 @@ export class SkillExecutionEngine {
if (options.verify && task.verify) {
const verificationPassed = await this.runVerification(task, taskResult);
if (!verificationPassed && !options.continueOnError) {
overallStatus = 'failed';
overallError = 'Verification failed';
overallStatus = "failed";
overallError = "Verification failed";
break;
}
}
@@ -178,7 +190,7 @@ export class SkillExecutionEngine {
const endTime = new Date();
// Complete the execution
if (overallStatus !== 'paused') {
if (overallStatus !== "paused") {
this.sessionManager.completeExecution(overallStatus, overallError);
}
@@ -190,20 +202,27 @@ export class SkillExecutionEngine {
completedAt: endTime.toISOString(),
durationMs: endTime.getTime() - startTime.getTime(),
tasks: taskResults,
filesModified: Array.from(new Set(taskResults.flatMap((t) => t.filesModified || []))),
commits: taskResults.map((t) => t.commitSha).filter((sha): sha is string => !!sha),
filesModified: Array.from(
new Set(taskResults.flatMap((t) => t.filesModified || [])),
),
commits: taskResults
.map((t) => t.commitSha)
.filter((sha): sha is string => !!sha),
error: overallError,
};
const statusMessages: Record<'completed' | 'failed' | 'cancelled' | 'paused', string> = {
completed: 'Skill execution completed',
paused: 'Skill execution paused',
failed: overallError || 'Skill execution failed',
cancelled: 'Skill execution cancelled',
const statusMessages: Record<
"completed" | "failed" | "cancelled" | "paused",
string
> = {
completed: "Skill execution completed",
paused: "Skill execution paused",
failed: overallError || "Skill execution failed",
cancelled: "Skill execution cancelled",
};
this.onProgress?.({
type: 'complete',
type: "complete",
status: overallStatus,
message: statusMessages[overallStatus],
});
@@ -216,11 +235,11 @@ export class SkillExecutionEngine {
*/
private async resumeExecution(
skill: ExecutableSkill,
options: ExecutionOptions
options: ExecutionOptions,
): Promise<SkillExecutionResult> {
const state = this.sessionManager.get();
if (!state?.currentExecution) {
throw new Error('No execution to resume');
throw new Error("No execution to resume");
}
this.sessionManager.resume();
@@ -228,7 +247,8 @@ export class SkillExecutionEngine {
const tasks = skill.tasks || [];
const taskResults: TaskExecutionResult[] = [];
let overallStatus: 'completed' | 'failed' | 'cancelled' | 'paused' = 'completed';
let overallStatus: "completed" | "failed" | "cancelled" | "paused" =
"completed";
let overallError: string | undefined;
// Find where to resume from
@@ -238,7 +258,7 @@ export class SkillExecutionEngine {
const task = tasks[i];
this.onProgress?.({
type: 'task_start',
type: "task_start",
taskId: task.id,
taskName: task.name,
taskIndex: i,
@@ -246,7 +266,7 @@ export class SkillExecutionEngine {
});
// Handle checkpoints (same as in execute)
if (task.type !== 'auto') {
if (task.type !== "auto") {
const checkpointResult = await this.handleCheckpoint(task, {
skillName: skill.name,
taskIndex: i,
@@ -254,17 +274,20 @@ export class SkillExecutionEngine {
});
if (!checkpointResult.continue) {
overallStatus = 'paused';
overallStatus = "paused";
this.sessionManager.pause();
break;
}
// For decision checkpoints, record the decision
if (task.type === 'checkpoint:decision' && checkpointResult.selectedOption) {
if (
task.type === "checkpoint:decision" &&
checkpointResult.selectedOption
) {
this.sessionManager.recordDecision(
`${skill.name}:${task.id}`,
checkpointResult.selectedOption,
skill.name
skill.name,
);
}
}
@@ -273,7 +296,7 @@ export class SkillExecutionEngine {
taskResults.push(taskResult);
this.sessionManager.updateTask(task.id || `task-${i}`, {
status: taskResult.status === 'completed' ? 'completed' : 'failed',
status: taskResult.status === "completed" ? "completed" : "failed",
output: taskResult.output,
error: taskResult.error,
filesModified: taskResult.filesModified,
@@ -282,7 +305,7 @@ export class SkillExecutionEngine {
// Emit task_complete progress event (matching execute behavior)
this.onProgress?.({
type: 'task_complete',
type: "task_complete",
taskId: task.id,
taskName: task.name,
taskIndex: i,
@@ -292,9 +315,9 @@ export class SkillExecutionEngine {
});
// Handle task failure
if (taskResult.status === 'failed') {
if (taskResult.status === "failed") {
if (!options.continueOnError) {
overallStatus = 'failed';
overallStatus = "failed";
overallError = taskResult.error;
break;
}
@@ -304,15 +327,15 @@ export class SkillExecutionEngine {
if (options.verify && task.verify) {
const verificationPassed = await this.runVerification(task, taskResult);
if (!verificationPassed && !options.continueOnError) {
overallStatus = 'failed';
overallError = 'Verification failed';
overallStatus = "failed";
overallError = "Verification failed";
break;
}
}
}
// Only complete execution if not paused
if (overallStatus !== 'paused') {
if (overallStatus !== "paused") {
this.sessionManager.completeExecution(overallStatus, overallError);
}
@@ -324,8 +347,12 @@ export class SkillExecutionEngine {
completedAt: new Date().toISOString(),
durationMs: Date.now() - new Date(execution.startedAt).getTime(),
tasks: taskResults,
filesModified: Array.from(new Set(taskResults.flatMap((t) => t.filesModified || []))),
commits: taskResults.map((t) => t.commitSha).filter((sha): sha is string => !!sha),
filesModified: Array.from(
new Set(taskResults.flatMap((t) => t.filesModified || [])),
),
commits: taskResults
.map((t) => t.commitSha)
.filter((sha): sha is string => !!sha),
error: overallError,
};
}
@@ -336,7 +363,7 @@ export class SkillExecutionEngine {
private async executeTask(
task: ExecutableTask,
_skill: ExecutableSkill,
_options: ExecutionOptions
_options: ExecutionOptions,
): Promise<TaskExecutionResult> {
const startTime = new Date();
const taskId = task.id || randomUUID();
@@ -354,7 +381,7 @@ export class SkillExecutionEngine {
return {
taskId,
taskName: task.name,
status: 'completed',
status: "completed",
startedAt: startTime.toISOString(),
completedAt: endTime.toISOString(),
durationMs: endTime.getTime() - startTime.getTime(),
@@ -367,7 +394,7 @@ export class SkillExecutionEngine {
return {
taskId,
taskName: task.name,
status: 'failed',
status: "failed",
startedAt: startTime.toISOString(),
completedAt: endTime.toISOString(),
durationMs: endTime.getTime() - startTime.getTime(),
@@ -381,10 +408,10 @@ export class SkillExecutionEngine {
*/
private async handleCheckpoint(
task: ExecutableTask,
context: { skillName: string; taskIndex: number; totalTasks: number }
context: { skillName: string; taskIndex: number; totalTasks: number },
): Promise<CheckpointResponse> {
this.onProgress?.({
type: 'checkpoint',
type: "checkpoint",
taskId: task.id,
taskName: task.name,
taskIndex: context.taskIndex,
@@ -397,7 +424,7 @@ export class SkillExecutionEngine {
}
// Default: auto-continue for non-decision checkpoints
if (task.type === 'checkpoint:decision') {
if (task.type === "checkpoint:decision") {
// Use first option if no handler
return {
continue: true,
@@ -447,7 +474,11 @@ export class SkillExecutionEngine {
* This method validates patterns before execution to prevent catastrophic backtracking.
* Note: This cannot guarantee protection against all ReDoS patterns, but catches common ones.
*/
private safeRegexTest(pattern: string, input: string, _timeoutMs = 1000): boolean {
private safeRegexTest(
pattern: string,
input: string,
_timeoutMs = 1000,
): boolean {
// Strict length limits to prevent excessive processing
if (pattern.length > 200 || input.length > 50000) {
console.warn(`Regex test skipped: pattern or input too long`);
@@ -456,7 +487,9 @@ export class SkillExecutionEngine {
// Reject patterns known to cause ReDoS
if (this.isUnsafeRegexPattern(pattern)) {
console.warn(`Regex pattern rejected as potentially unsafe: ${pattern.slice(0, 50)}...`);
console.warn(
`Regex pattern rejected as potentially unsafe: ${pattern.slice(0, 50)}...`,
);
return false;
}
@@ -478,7 +511,7 @@ export class SkillExecutionEngine {
*/
private async runVerification(
task: ExecutableTask,
result: TaskExecutionResult
result: TaskExecutionResult,
): Promise<boolean> {
if (!task.verify) {
return true;
@@ -494,21 +527,23 @@ export class SkillExecutionEngine {
for (const rule of task.verify.automated) {
if (rule.command) {
try {
// SECURITY: Commands are from skill config - only run trusted skills
const output = execSync(rule.command, {
const cmdParts = splitCommand(rule.command);
if (cmdParts.length === 0) return false;
const [cmd, ...sanitizedArgs] = cmdParts;
const output = execFileSync(cmd, sanitizedArgs, {
cwd: this.projectPath,
encoding: 'utf-8',
encoding: "utf-8",
timeout: 30000,
});
let passed = true;
if (rule.expect) {
if (rule.expect === 'success') {
if (rule.expect === "success") {
passed = true;
} else if (rule.expect.startsWith('contains:')) {
} else if (rule.expect.startsWith("contains:")) {
const expected = rule.expect.slice(9);
passed = output.includes(expected);
} else if (rule.expect.startsWith('matches:')) {
} else if (rule.expect.startsWith("matches:")) {
const pattern = rule.expect.slice(8);
// Use safe regex test to prevent ReDoS
passed = this.safeRegexTest(pattern, output);
@@ -522,10 +557,10 @@ export class SkillExecutionEngine {
});
this.onProgress?.({
type: 'verification',
type: "verification",
taskId: task.id,
taskName: task.name,
message: `Verification ${passed ? 'passed' : 'failed'}: ${rule.command}`,
message: `Verification ${passed ? "passed" : "failed"}: ${rule.command}`,
});
if (!passed) {
@@ -557,18 +592,18 @@ export class SkillExecutionEngine {
return {
skillName: skill.name,
skillSource: skill.source,
status: 'completed',
status: "completed",
startedAt: new Date().toISOString(),
completedAt: new Date().toISOString(),
durationMs: 0,
tasks: tasks.map((task) => ({
taskId: task.id || randomUUID(),
taskName: task.name,
status: 'skipped' as ExecutionTaskStatus,
status: "skipped" as ExecutionTaskStatus,
startedAt: new Date().toISOString(),
completedAt: new Date().toISOString(),
durationMs: 0,
output: '[Dry run - not executed]',
output: "[Dry run - not executed]",
})),
filesModified: [],
commits: [],
@@ -605,7 +640,7 @@ export function createExecutionEngine(
options?: {
checkpointHandler?: CheckpointHandler;
onProgress?: ExecutionProgressCallback;
}
},
): SkillExecutionEngine {
return new SkillExecutionEngine(projectPath, options);
}
+3
View File
@@ -132,3 +132,6 @@ export * from './agents-md/index.js';
// Save (Content Extraction & Skill Generation)
export * from './save/index.js';
// Utilities
export { splitCommand } from './utils/shell.js';
+117 -50
View File
@@ -13,7 +13,9 @@ import type {
PlanExecutionResult,
PlanEvent,
PlanEventListener,
} from './types.js';
} from "./types.js";
import { execFileSync } from "node:child_process";
import { splitCommand } from "../utils/shell.js";
/**
* Step executor function type
@@ -21,7 +23,7 @@ import type {
export type StepExecutor = (
step: TaskStep,
task: PlanTask,
plan: StructuredPlan
plan: StructuredPlan,
) => Promise<{ success: boolean; output: string; error?: string }>;
/**
@@ -49,7 +51,10 @@ export class PlanExecutor {
/**
* Execute a plan
*/
async execute(plan: StructuredPlan, options?: PlanExecutionOptions): Promise<PlanExecutionResult> {
async execute(
plan: StructuredPlan,
options?: PlanExecutionOptions,
): Promise<PlanExecutionResult> {
const startTime = Date.now();
let aborted = false;
const result: PlanExecutionResult = {
@@ -66,8 +71,8 @@ export class PlanExecutor {
this.isPaused = false;
// Update plan status
plan.status = 'executing';
this.emit('plan:execution_started', plan);
plan.status = "executing";
this.emit("plan:execution_started", plan);
try {
// Build dependency graph
@@ -82,7 +87,7 @@ export class PlanExecutor {
if (this.abortController.signal.aborted) {
aborted = true;
result.success = false;
result.errors = [...(result.errors ?? []), 'Execution cancelled'];
result.errors = [...(result.errors ?? []), "Execution cancelled"];
break;
}
@@ -93,7 +98,7 @@ export class PlanExecutor {
if (this.abortController.signal.aborted) {
aborted = true;
result.success = false;
result.errors = [...(result.errors ?? []), 'Execution cancelled'];
result.errors = [...(result.errors ?? []), "Execution cancelled"];
break;
}
@@ -103,7 +108,7 @@ export class PlanExecutor {
// Check if dependencies completed
const depsCompleted = this.checkDependencies(task, result);
if (!depsCompleted) {
task.status = 'skipped';
task.status = "skipped";
result.skippedTasks.push(taskId);
continue;
}
@@ -113,23 +118,27 @@ export class PlanExecutor {
result.taskResults.set(taskId, taskResult);
if (taskResult.success) {
task.status = 'completed';
task.status = "completed";
task.result = taskResult;
result.completedTasks.push(taskId);
this.emit('plan:task_completed', plan, task, taskResult);
this.emit("plan:task_completed", plan, task, taskResult);
} else {
task.status = 'failed';
task.status = "failed";
task.result = taskResult;
result.failedTasks.push(taskId);
result.success = false;
this.emit('plan:task_failed', plan, task, taskResult);
this.emit("plan:task_failed", plan, task, taskResult);
if (options?.stopOnError) {
// Mark remaining tasks as skipped
for (const remainingId of executionOrder.slice(executionOrder.indexOf(taskId) + 1)) {
const remainingTask = plan.tasks.find((t) => t.id === remainingId);
for (const remainingId of executionOrder.slice(
executionOrder.indexOf(taskId) + 1,
)) {
const remainingTask = plan.tasks.find(
(t) => t.id === remainingId,
);
if (remainingTask) {
remainingTask.status = 'skipped';
remainingTask.status = "skipped";
result.skippedTasks.push(remainingId);
}
}
@@ -139,28 +148,32 @@ export class PlanExecutor {
}
// Update plan status
plan.status = aborted ? 'cancelled' : result.success ? 'completed' : 'failed';
plan.status = aborted
? "cancelled"
: result.success
? "completed"
: "failed";
plan.updatedAt = new Date();
result.durationMs = Date.now() - startTime;
// Emit appropriate event
if (aborted) {
this.emit('plan:execution_cancelled', plan);
this.emit("plan:execution_cancelled", plan);
} else if (result.success) {
this.emit('plan:execution_completed', plan);
this.emit("plan:execution_completed", plan);
} else {
this.emit('plan:execution_failed', plan);
this.emit("plan:execution_failed", plan);
}
return result;
} catch (error) {
plan.status = 'failed';
plan.status = "failed";
result.success = false;
result.durationMs = Date.now() - startTime;
result.errors = [(error as Error).message];
this.emit('plan:execution_failed', plan);
this.emit("plan:execution_failed", plan);
return result;
} finally {
// Reset executor state
@@ -177,18 +190,18 @@ export class PlanExecutor {
private async executeTask(
task: PlanTask,
plan: StructuredPlan,
options?: PlanExecutionOptions
options?: PlanExecutionOptions,
): Promise<PlanTaskResult> {
const startTime = Date.now();
const errors: string[] = [];
const filesCreated: string[] = [];
const filesModified: string[] = [];
task.status = 'in_progress';
this.emit('plan:task_started', plan, task);
task.status = "in_progress";
this.emit("plan:task_started", plan, task);
// Report progress
options?.onProgress?.(task.id, 0, 'starting');
options?.onProgress?.(task.id, 0, "starting");
// Execute steps
for (let i = 0; i < task.steps.length; i++) {
@@ -196,7 +209,7 @@ export class PlanExecutor {
// Check if aborted
if (this.abortController?.signal.aborted) {
errors.push('Execution aborted');
errors.push("Execution aborted");
break;
}
@@ -205,17 +218,23 @@ export class PlanExecutor {
// Re-check if aborted after resuming from pause
if (this.abortController?.signal.aborted) {
errors.push('Execution aborted');
errors.push("Execution aborted");
break;
}
// Report progress
options?.onProgress?.(task.id, step.number, `executing step ${step.number}`);
options?.onProgress?.(
task.id,
step.number,
`executing step ${step.number}`,
);
// Execute step
if (options?.dryRun) {
// Dry run - just log
console.log(`[DRY RUN] Task ${task.id}, Step ${step.number}: ${step.description}`);
console.log(
`[DRY RUN] Task ${task.id}, Step ${step.number}: ${step.description}`,
);
if (step.command) {
console.log(` Command: ${step.command}`);
}
@@ -226,11 +245,11 @@ export class PlanExecutor {
try {
const stepResult = await this.executeWithTimeout(
this.stepExecutor(step, task, plan),
options?.taskTimeout || 60000
options?.taskTimeout || 60000,
);
if (!stepResult.success) {
errors.push(`Step ${step.number}: ${stepResult.error || 'Failed'}`);
errors.push(`Step ${step.number}: ${stepResult.error || "Failed"}`);
if (step.critical) {
break;
@@ -245,7 +264,7 @@ export class PlanExecutor {
}
} else {
// No step executor configured - fail fast
errors.push('No step executor configured');
errors.push("No step executor configured");
break;
}
}
@@ -256,7 +275,10 @@ export class PlanExecutor {
const result: PlanTaskResult = {
success: errors.length === 0,
output: errors.length === 0 ? `Task ${task.id} completed successfully` : `Task ${task.id} failed`,
output:
errors.length === 0
? `Task ${task.id} completed successfully`
: `Task ${task.id} failed`,
filesCreated: filesCreated.length > 0 ? filesCreated : undefined,
filesModified: filesModified.length > 0 ? filesModified : undefined,
errors: errors.length > 0 ? errors : undefined,
@@ -273,10 +295,15 @@ export class PlanExecutor {
/**
* Execute with timeout
*/
private async executeWithTimeout<T>(promise: Promise<T>, timeoutMs: number): Promise<T> {
private async executeWithTimeout<T>(
promise: Promise<T>,
timeoutMs: number,
): Promise<T> {
return Promise.race([
promise,
new Promise<T>((_, reject) => setTimeout(() => reject(new Error('Timeout')), timeoutMs)),
new Promise<T>((_, reject) =>
setTimeout(() => reject(new Error("Timeout")), timeoutMs),
),
]);
}
@@ -296,7 +323,10 @@ export class PlanExecutor {
/**
* Get execution order using topological sort
*/
private getExecutionOrder(plan: StructuredPlan, graph: Map<number, number[]>): number[] {
private getExecutionOrder(
plan: StructuredPlan,
graph: Map<number, number[]>,
): number[] {
const order: number[] = [];
const visited = new Set<number>();
const temp = new Set<number>();
@@ -331,12 +361,17 @@ export class PlanExecutor {
/**
* Check if dependencies are completed
*/
private checkDependencies(task: PlanTask, result: PlanExecutionResult): boolean {
private checkDependencies(
task: PlanTask,
result: PlanExecutionResult,
): boolean {
if (!task.dependencies || task.dependencies.length === 0) {
return true;
}
return task.dependencies.every((depId) => result.completedTasks.includes(depId));
return task.dependencies.every((depId) =>
result.completedTasks.includes(depId),
);
}
/**
@@ -348,7 +383,7 @@ export class PlanExecutor {
this.resumePromise = new Promise((resolve) => {
this.resumeResolve = resolve;
});
this.emit('plan:paused', {} as StructuredPlan);
this.emit("plan:paused", {} as StructuredPlan);
}
}
@@ -361,7 +396,7 @@ export class PlanExecutor {
this.resumeResolve();
this.resumeResolve = undefined;
this.resumePromise = undefined;
this.emit('plan:resumed', {} as StructuredPlan);
this.emit("plan:resumed", {} as StructuredPlan);
}
}
@@ -406,7 +441,12 @@ export class PlanExecutor {
/**
* Emit event
*/
private emit(event: PlanEvent, plan: StructuredPlan, task?: PlanTask, result?: PlanTaskResult): void {
private emit(
event: PlanEvent,
plan: StructuredPlan,
task?: PlanTask,
result?: PlanTaskResult,
): void {
for (const listener of this.listeners) {
try {
listener(event, plan, task, result);
@@ -420,7 +460,9 @@ export class PlanExecutor {
* Check if currently executing
*/
isExecuting(): boolean {
return this.abortController !== undefined && !this.abortController.signal.aborted;
return (
this.abortController !== undefined && !this.abortController.signal.aborted
);
}
/**
@@ -434,7 +476,9 @@ export class PlanExecutor {
/**
* Create a PlanExecutor instance
*/
export function createPlanExecutor(options?: { stepExecutor?: StepExecutor }): PlanExecutor {
export function createPlanExecutor(options?: {
stepExecutor?: StepExecutor;
}): PlanExecutor {
return new PlanExecutor(options);
}
@@ -442,23 +486,46 @@ export function createPlanExecutor(options?: { stepExecutor?: StepExecutor }): P
* Default step executor (dry run)
*/
export const dryRunExecutor: StepExecutor = async (step, task, _plan) => {
console.log(`[DRY RUN] Task ${task.id}, Step ${step.number}: ${step.description}`);
return { success: true, output: 'Dry run completed' };
console.log(
`[DRY RUN] Task ${task.id}, Step ${step.number}: ${step.description}`,
);
return { success: true, output: "Dry run completed" };
};
/**
* Shell step executor (runs commands)
*
* Uses execFileSync for simple commands (no shell metacharacters) to prevent
* injection. Falls back to sh -c for commands that require shell features
* like pipes, redirects, or subshells — these come from plan configs,
* not user input.
*/
export const shellExecutor: StepExecutor = async (step, _task, _plan) => {
if (!step.command) {
return { success: true, output: 'No command to execute' };
return { success: true, output: "No command to execute" };
}
try {
const { execSync } = await import('node:child_process');
const output = execSync(step.command, { encoding: 'utf-8', timeout: 60000 });
const needsShell = /[|><;`$(){}]/.test(step.command);
let output: string;
if (needsShell) {
output = execFileSync("sh", ["-c", step.command], {
encoding: "utf-8",
timeout: 60000,
});
} else {
const parts = splitCommand(step.command);
if (parts.length === 0) {
return { success: false, output: "", error: "Empty command" };
}
const [cmd, ...args] = parts;
output = execFileSync(cmd, args, {
encoding: "utf-8",
timeout: 60000,
});
}
// Check expected output if provided
if (step.expectedOutput && !output.includes(step.expectedOutput)) {
return {
success: false,
@@ -471,7 +538,7 @@ export const shellExecutor: StepExecutor = async (step, _task, _plan) => {
} catch (error) {
return {
success: false,
output: '',
output: "",
error: (error as Error).message,
};
}
+47 -35
View File
@@ -1,35 +1,41 @@
import { execSync } from 'node:child_process';
import { existsSync, rmSync } from 'node:fs';
import { join, basename } from 'node:path';
import { tmpdir } from 'node:os';
import { randomUUID } from 'node:crypto';
import type { GitProviderAdapter, CloneOptions } from './base.js';
import { parseShorthand } from './base.js';
import type { GitProvider, CloneResult } from '../types.js';
import { discoverSkills } from '../skills.js';
import { execFileSync } from "node:child_process";
import { existsSync, rmSync } from "node:fs";
import { join, basename } from "node:path";
import { tmpdir } from "node:os";
import { randomUUID } from "node:crypto";
import type { GitProviderAdapter, CloneOptions } from "./base.js";
import { parseShorthand } from "./base.js";
import type { GitProvider, CloneResult } from "../types.js";
import { discoverSkills } from "../skills.js";
export class BitbucketProvider implements GitProviderAdapter {
readonly type: GitProvider = 'bitbucket';
readonly name = 'Bitbucket';
readonly baseUrl = 'https://bitbucket.org';
readonly type: GitProvider = "bitbucket";
readonly name = "Bitbucket";
readonly baseUrl = "https://bitbucket.org";
parseSource(source: string): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith('https://bitbucket.org/')) {
const path = source.replace('https://bitbucket.org/', '').replace(/\.git$/, '');
parseSource(
source: string,
): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith("https://bitbucket.org/")) {
const path = source
.replace("https://bitbucket.org/", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('git@bitbucket.org:')) {
const path = source.replace('git@bitbucket.org:', '').replace(/\.git$/, '');
if (source.startsWith("git@bitbucket.org:")) {
const path = source
.replace("git@bitbucket.org:", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('bitbucket:')) {
return parseShorthand(source.replace('bitbucket:', ''));
if (source.startsWith("bitbucket:")) {
return parseShorthand(source.replace("bitbucket:", ""));
}
if (source.startsWith('bitbucket.org/')) {
return parseShorthand(source.replace('bitbucket.org/', ''));
if (source.startsWith("bitbucket.org/")) {
return parseShorthand(source.replace("bitbucket.org/", ""));
}
return null;
@@ -37,10 +43,10 @@ export class BitbucketProvider implements GitProviderAdapter {
matches(source: string): boolean {
return (
source.startsWith('https://bitbucket.org/') ||
source.startsWith('git@bitbucket.org:') ||
source.startsWith('bitbucket:') ||
source.startsWith('bitbucket.org/')
source.startsWith("https://bitbucket.org/") ||
source.startsWith("git@bitbucket.org:") ||
source.startsWith("bitbucket:") ||
source.startsWith("bitbucket.org/")
);
}
@@ -52,30 +58,36 @@ export class BitbucketProvider implements GitProviderAdapter {
return `git@bitbucket.org:${owner}/${repo}.git`;
}
async clone(source: string, _targetDir: string, options: CloneOptions = {}): Promise<CloneResult> {
async clone(
source: string,
_targetDir: string,
options: CloneOptions = {},
): Promise<CloneResult> {
const parsed = this.parseSource(source);
if (!parsed) {
return { success: false, error: `Invalid Bitbucket source: ${source}` };
}
const { owner, repo, subpath } = parsed;
const cloneUrl = options.ssh ? this.getSshUrl(owner, repo) : this.getCloneUrl(owner, repo);
const cloneUrl = options.ssh
? this.getSshUrl(owner, repo)
: this.getCloneUrl(owner, repo);
const tempDir = join(tmpdir(), `skillkit-${randomUUID()}`);
try {
const args = ['clone'];
const args = ["clone"];
if (options.depth) {
args.push('--depth', String(options.depth));
args.push("--depth", String(options.depth));
}
if (options.branch) {
args.push('--branch', options.branch);
args.push("--branch", options.branch);
}
args.push(cloneUrl, tempDir);
execSync(`git ${args.join(' ')}`, {
stdio: ['pipe', 'pipe', 'pipe'],
encoding: 'utf-8',
execFileSync("git", args, {
stdio: ["pipe", "pipe", "pipe"],
encoding: "utf-8",
});
const searchDir = subpath ? join(tempDir, subpath) : tempDir;
@@ -85,8 +97,8 @@ export class BitbucketProvider implements GitProviderAdapter {
success: true,
path: searchDir,
tempRoot: tempDir,
skills: skills.map(s => s.name),
discoveredSkills: skills.map(s => ({
skills: skills.map((s) => s.name),
discoveredSkills: skills.map((s) => ({
name: s.name,
dirName: basename(s.path),
path: s.path,
+41 -31
View File
@@ -1,30 +1,34 @@
import { execSync } from 'node:child_process';
import { existsSync, rmSync } from 'node:fs';
import { join, basename } from 'node:path';
import { tmpdir } from 'node:os';
import { randomUUID } from 'node:crypto';
import type { GitProviderAdapter, CloneOptions } from './base.js';
import { parseShorthand, isGitUrl } from './base.js';
import type { GitProvider, CloneResult } from '../types.js';
import { discoverSkills } from '../skills.js';
import { execFileSync } from "node:child_process";
import { existsSync, rmSync } from "node:fs";
import { join, basename } from "node:path";
import { tmpdir } from "node:os";
import { randomUUID } from "node:crypto";
import type { GitProviderAdapter, CloneOptions } from "./base.js";
import { parseShorthand, isGitUrl } from "./base.js";
import type { GitProvider, CloneResult } from "../types.js";
import { discoverSkills } from "../skills.js";
export class GitHubProvider implements GitProviderAdapter {
readonly type: GitProvider = 'github';
readonly name = 'GitHub';
readonly baseUrl = 'https://github.com';
readonly type: GitProvider = "github";
readonly name = "GitHub";
readonly baseUrl = "https://github.com";
parseSource(source: string): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith('https://github.com/')) {
const path = source.replace('https://github.com/', '').replace(/\.git$/, '');
parseSource(
source: string,
): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith("https://github.com/")) {
const path = source
.replace("https://github.com/", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('git@github.com:')) {
const path = source.replace('git@github.com:', '').replace(/\.git$/, '');
if (source.startsWith("git@github.com:")) {
const path = source.replace("git@github.com:", "").replace(/\.git$/, "");
return parseShorthand(path);
}
if (!isGitUrl(source) && !source.includes(':')) {
if (!isGitUrl(source) && !source.includes(":")) {
return parseShorthand(source);
}
@@ -33,9 +37,9 @@ export class GitHubProvider implements GitProviderAdapter {
matches(source: string): boolean {
return (
source.startsWith('https://github.com/') ||
source.startsWith('git@github.com:') ||
(!isGitUrl(source) && !source.includes(':') && source.includes('/'))
source.startsWith("https://github.com/") ||
source.startsWith("git@github.com:") ||
(!isGitUrl(source) && !source.includes(":") && source.includes("/"))
);
}
@@ -47,30 +51,36 @@ export class GitHubProvider implements GitProviderAdapter {
return `git@github.com:${owner}/${repo}.git`;
}
async clone(source: string, _targetDir: string, options: CloneOptions = {}): Promise<CloneResult> {
async clone(
source: string,
_targetDir: string,
options: CloneOptions = {},
): Promise<CloneResult> {
const parsed = this.parseSource(source);
if (!parsed) {
return { success: false, error: `Invalid GitHub source: ${source}` };
}
const { owner, repo, subpath } = parsed;
const cloneUrl = options.ssh ? this.getSshUrl(owner, repo) : this.getCloneUrl(owner, repo);
const cloneUrl = options.ssh
? this.getSshUrl(owner, repo)
: this.getCloneUrl(owner, repo);
const tempDir = join(tmpdir(), `skillkit-${randomUUID()}`);
try {
const args = ['clone'];
const args = ["clone"];
if (options.depth) {
args.push('--depth', String(options.depth));
args.push("--depth", String(options.depth));
}
if (options.branch) {
args.push('--branch', options.branch);
args.push("--branch", options.branch);
}
args.push(cloneUrl, tempDir);
execSync(`git ${args.join(' ')}`, {
stdio: ['pipe', 'pipe', 'pipe'],
encoding: 'utf-8',
execFileSync("git", args, {
stdio: ["pipe", "pipe", "pipe"],
encoding: "utf-8",
});
const searchDir = subpath ? join(tempDir, subpath) : tempDir;
@@ -80,8 +90,8 @@ export class GitHubProvider implements GitProviderAdapter {
success: true,
path: searchDir,
tempRoot: tempDir,
skills: skills.map(s => s.name),
discoveredSkills: skills.map(s => ({
skills: skills.map((s) => s.name),
discoveredSkills: skills.map((s) => ({
name: s.name,
dirName: basename(s.path),
path: s.path,
+45 -35
View File
@@ -1,35 +1,39 @@
import { execSync } from 'node:child_process';
import { existsSync, rmSync } from 'node:fs';
import { join, basename } from 'node:path';
import { tmpdir } from 'node:os';
import { randomUUID } from 'node:crypto';
import type { GitProviderAdapter, CloneOptions } from './base.js';
import { parseShorthand } from './base.js';
import type { GitProvider, CloneResult } from '../types.js';
import { discoverSkills } from '../skills.js';
import { execFileSync } from "node:child_process";
import { existsSync, rmSync } from "node:fs";
import { join, basename } from "node:path";
import { tmpdir } from "node:os";
import { randomUUID } from "node:crypto";
import type { GitProviderAdapter, CloneOptions } from "./base.js";
import { parseShorthand } from "./base.js";
import type { GitProvider, CloneResult } from "../types.js";
import { discoverSkills } from "../skills.js";
export class GitLabProvider implements GitProviderAdapter {
readonly type: GitProvider = 'gitlab';
readonly name = 'GitLab';
readonly baseUrl = 'https://gitlab.com';
readonly type: GitProvider = "gitlab";
readonly name = "GitLab";
readonly baseUrl = "https://gitlab.com";
parseSource(source: string): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith('https://gitlab.com/')) {
const path = source.replace('https://gitlab.com/', '').replace(/\.git$/, '');
parseSource(
source: string,
): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith("https://gitlab.com/")) {
const path = source
.replace("https://gitlab.com/", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('git@gitlab.com:')) {
const path = source.replace('git@gitlab.com:', '').replace(/\.git$/, '');
if (source.startsWith("git@gitlab.com:")) {
const path = source.replace("git@gitlab.com:", "").replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('gitlab:')) {
return parseShorthand(source.replace('gitlab:', ''));
if (source.startsWith("gitlab:")) {
return parseShorthand(source.replace("gitlab:", ""));
}
if (source.startsWith('gitlab.com/')) {
return parseShorthand(source.replace('gitlab.com/', ''));
if (source.startsWith("gitlab.com/")) {
return parseShorthand(source.replace("gitlab.com/", ""));
}
return null;
@@ -37,10 +41,10 @@ export class GitLabProvider implements GitProviderAdapter {
matches(source: string): boolean {
return (
source.startsWith('https://gitlab.com/') ||
source.startsWith('git@gitlab.com:') ||
source.startsWith('gitlab:') ||
source.startsWith('gitlab.com/')
source.startsWith("https://gitlab.com/") ||
source.startsWith("git@gitlab.com:") ||
source.startsWith("gitlab:") ||
source.startsWith("gitlab.com/")
);
}
@@ -52,30 +56,36 @@ export class GitLabProvider implements GitProviderAdapter {
return `git@gitlab.com:${owner}/${repo}.git`;
}
async clone(source: string, _targetDir: string, options: CloneOptions = {}): Promise<CloneResult> {
async clone(
source: string,
_targetDir: string,
options: CloneOptions = {},
): Promise<CloneResult> {
const parsed = this.parseSource(source);
if (!parsed) {
return { success: false, error: `Invalid GitLab source: ${source}` };
}
const { owner, repo, subpath } = parsed;
const cloneUrl = options.ssh ? this.getSshUrl(owner, repo) : this.getCloneUrl(owner, repo);
const cloneUrl = options.ssh
? this.getSshUrl(owner, repo)
: this.getCloneUrl(owner, repo);
const tempDir = join(tmpdir(), `skillkit-${randomUUID()}`);
try {
const args = ['clone'];
const args = ["clone"];
if (options.depth) {
args.push('--depth', String(options.depth));
args.push("--depth", String(options.depth));
}
if (options.branch) {
args.push('--branch', options.branch);
args.push("--branch", options.branch);
}
args.push(cloneUrl, tempDir);
execSync(`git ${args.join(' ')}`, {
stdio: ['pipe', 'pipe', 'pipe'],
encoding: 'utf-8',
execFileSync("git", args, {
stdio: ["pipe", "pipe", "pipe"],
encoding: "utf-8",
});
const searchDir = subpath ? join(tempDir, subpath) : tempDir;
@@ -85,8 +95,8 @@ export class GitLabProvider implements GitProviderAdapter {
success: true,
path: searchDir,
tempRoot: tempDir,
skills: skills.map(s => s.name),
discoveredSkills: skills.map(s => ({
skills: skills.map((s) => s.name),
discoveredSkills: skills.map((s) => ({
name: s.name,
dirName: basename(s.path),
path: s.path,
+105 -62
View File
@@ -1,24 +1,42 @@
import { execSync } from 'node:child_process';
import { existsSync, rmSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
import { join } from 'node:path';
import { tmpdir, homedir } from 'node:os';
import { randomUUID } from 'node:crypto';
import type { SkillIndex, SkillSummary, IndexSource } from './types.js';
import { discoverSkills, extractFrontmatter } from '../skills.js';
import { execFileSync } from "node:child_process";
import {
existsSync,
rmSync,
readFileSync,
writeFileSync,
mkdirSync,
} from "node:fs";
import { join, dirname } from "node:path";
import { tmpdir, homedir } from "node:os";
import { randomUUID } from "node:crypto";
import type { SkillIndex, SkillSummary, IndexSource } from "./types.js";
import { discoverSkills, extractFrontmatter } from "../skills.js";
/**
* Known skill repositories to index
*/
export const KNOWN_SKILL_REPOS = [
{ owner: 'anthropics', repo: 'courses', description: 'Anthropic official courses and skills' },
{ owner: 'vercel-labs', repo: 'ai-sdk-preview-internal-knowledge-base', description: 'Vercel AI SDK skills' },
{ owner: 'composioHQ', repo: 'awesome-claude-code-skills', description: 'Curated Claude Code skills' },
{
owner: "anthropics",
repo: "courses",
description: "Anthropic official courses and skills",
},
{
owner: "vercel-labs",
repo: "ai-sdk-preview-internal-knowledge-base",
description: "Vercel AI SDK skills",
},
{
owner: "composioHQ",
repo: "awesome-claude-skills",
description: "Curated Claude Code skills",
},
] as const;
/**
* Index file path
*/
export const INDEX_PATH = join(homedir(), '.skillkit', 'index.json');
export const INDEX_PATH = join(homedir(), ".skillkit", "index.json");
export const INDEX_CACHE_HOURS = 24;
/**
@@ -26,17 +44,24 @@ export const INDEX_CACHE_HOURS = 24;
*/
export async function fetchSkillsFromRepo(
owner: string,
repo: string
repo: string,
): Promise<{ skills: SkillSummary[]; error?: string }> {
if (!/^[\w.-]+$/.test(owner) || !/^[\w.-]+$/.test(repo)) {
return {
skills: [],
error: `Invalid owner or repo name: ${owner}/${repo}`,
};
}
const cloneUrl = `https://github.com/${owner}/${repo}.git`;
const tempDir = join(tmpdir(), `skillkit-fetch-${randomUUID()}`);
try {
// Shallow clone for speed
execSync(`git clone --depth 1 ${cloneUrl} ${tempDir}`, {
stdio: ['pipe', 'pipe', 'pipe'],
encoding: 'utf-8',
timeout: 60000, // 60 second timeout
execFileSync("git", ["clone", "--depth", "1", cloneUrl, tempDir], {
stdio: ["pipe", "pipe", "pipe"],
encoding: "utf-8",
timeout: 60000,
});
// Discover skills in the cloned repo
@@ -44,27 +69,36 @@ export async function fetchSkillsFromRepo(
const skills: SkillSummary[] = [];
for (const skill of discoveredSkills) {
const skillMdPath = join(skill.path, 'SKILL.md');
const skillMdPath = join(skill.path, "SKILL.md");
if (!existsSync(skillMdPath)) continue;
try {
const content = readFileSync(skillMdPath, 'utf-8');
const content = readFileSync(skillMdPath, "utf-8");
const frontmatter = extractFrontmatter(content);
const summary: SkillSummary = {
name: skill.name,
description: skill.description || frontmatter?.description as string || 'No description',
description:
skill.description ||
(frontmatter?.description as string) ||
"No description",
source: `${owner}/${repo}`,
tags: (frontmatter?.tags as string[]) || [],
compatibility: {
frameworks: (frontmatter?.compatibility as Record<string, unknown>)?.frameworks as string[] || [],
languages: (frontmatter?.compatibility as Record<string, unknown>)?.languages as string[] || [],
libraries: (frontmatter?.compatibility as Record<string, unknown>)?.libraries as string[] || [],
frameworks:
((frontmatter?.compatibility as Record<string, unknown>)
?.frameworks as string[]) || [],
languages:
((frontmatter?.compatibility as Record<string, unknown>)
?.languages as string[]) || [],
libraries:
((frontmatter?.compatibility as Record<string, unknown>)
?.libraries as string[]) || [],
},
popularity: 0,
quality: 50,
lastUpdated: new Date().toISOString(),
verified: owner === 'anthropics' || owner === 'vercel-labs',
verified: owner === "anthropics" || owner === "vercel-labs",
};
skills.push(summary);
@@ -76,7 +110,10 @@ export async function fetchSkillsFromRepo(
return { skills };
} catch (error) {
const message = error instanceof Error ? error.message : String(error);
return { skills: [], error: `Failed to fetch ${owner}/${repo}: ${message}` };
return {
skills: [],
error: `Failed to fetch ${owner}/${repo}: ${message}`,
};
} finally {
// Clean up temp directory
if (existsSync(tempDir)) {
@@ -94,7 +131,7 @@ export async function fetchSkillsFromRepo(
*/
export async function buildSkillIndex(
repos: typeof KNOWN_SKILL_REPOS = KNOWN_SKILL_REPOS,
onProgress?: (message: string) => void
onProgress?: (message: string) => void,
): Promise<{ index: SkillIndex; errors: string[] }> {
const allSkills: SkillSummary[] = [];
const sources: IndexSource[] = [];
@@ -125,11 +162,11 @@ export async function buildSkillIndex(
// Add fallback sample skills if no repos could be fetched
if (allSkills.length === 0) {
onProgress?.('No skills fetched, using sample index...');
onProgress?.("No skills fetched, using sample index...");
allSkills.push(...getSampleSkills());
sources.push({
name: 'built-in',
url: 'https://github.com/rohitg00/skillkit',
name: "built-in",
url: "https://github.com/rohitg00/skillkit",
lastFetched: new Date().toISOString(),
skillCount: allSkills.length,
});
@@ -149,7 +186,7 @@ export async function buildSkillIndex(
* Save skill index to cache
*/
export function saveIndex(index: SkillIndex): void {
const indexDir = join(homedir(), '.skillkit');
const indexDir = dirname(INDEX_PATH);
if (!existsSync(indexDir)) {
mkdirSync(indexDir, { recursive: true });
}
@@ -165,7 +202,7 @@ export function loadIndex(): SkillIndex | null {
}
try {
const content = readFileSync(INDEX_PATH, 'utf-8');
const content = readFileSync(INDEX_PATH, "utf-8");
return JSON.parse(content) as SkillIndex;
} catch {
return null;
@@ -177,17 +214,18 @@ export function loadIndex(): SkillIndex | null {
*/
export function isIndexStale(index: SkillIndex): boolean {
const lastUpdated = new Date(index.lastUpdated);
const hoursSinceUpdate = (Date.now() - lastUpdated.getTime()) / (1000 * 60 * 60);
const hoursSinceUpdate =
(Date.now() - lastUpdated.getTime()) / (1000 * 60 * 60);
return hoursSinceUpdate > INDEX_CACHE_HOURS;
}
/**
* Get index status
*/
export function getIndexStatus(): 'missing' | 'stale' | 'fresh' {
export function getIndexStatus(): "missing" | "stale" | "fresh" {
const index = loadIndex();
if (!index) return 'missing';
return isIndexStale(index) ? 'stale' : 'fresh';
if (!index) return "missing";
return isIndexStale(index) ? "stale" : "fresh";
}
/**
@@ -196,13 +234,14 @@ export function getIndexStatus(): 'missing' | 'stale' | 'fresh' {
function getSampleSkills(): SkillSummary[] {
return [
{
name: 'react-best-practices',
description: 'Modern React patterns including Server Components, hooks best practices, and performance optimization',
source: 'built-in',
tags: ['react', 'frontend', 'typescript', 'nextjs', 'performance'],
name: "react-best-practices",
description:
"Modern React patterns including Server Components, hooks best practices, and performance optimization",
source: "built-in",
tags: ["react", "frontend", "typescript", "nextjs", "performance"],
compatibility: {
frameworks: ['react', 'nextjs'],
languages: ['typescript', 'javascript'],
frameworks: ["react", "nextjs"],
languages: ["typescript", "javascript"],
libraries: [],
},
popularity: 1500,
@@ -211,14 +250,15 @@ function getSampleSkills(): SkillSummary[] {
verified: true,
},
{
name: 'tailwind-patterns',
description: 'Tailwind CSS utility patterns, responsive design, and component styling best practices',
source: 'built-in',
tags: ['tailwind', 'css', 'styling', 'frontend', 'responsive'],
name: "tailwind-patterns",
description:
"Tailwind CSS utility patterns, responsive design, and component styling best practices",
source: "built-in",
tags: ["tailwind", "css", "styling", "frontend", "responsive"],
compatibility: {
frameworks: [],
languages: ['typescript', 'javascript'],
libraries: ['tailwindcss'],
languages: ["typescript", "javascript"],
libraries: ["tailwindcss"],
},
popularity: 1200,
quality: 92,
@@ -226,13 +266,14 @@ function getSampleSkills(): SkillSummary[] {
verified: true,
},
{
name: 'typescript-strict-patterns',
description: 'TypeScript strict mode patterns, type safety, and advanced type utilities',
source: 'built-in',
tags: ['typescript', 'types', 'safety', 'patterns'],
name: "typescript-strict-patterns",
description:
"TypeScript strict mode patterns, type safety, and advanced type utilities",
source: "built-in",
tags: ["typescript", "types", "safety", "patterns"],
compatibility: {
frameworks: [],
languages: ['typescript'],
languages: ["typescript"],
libraries: [],
},
popularity: 900,
@@ -241,13 +282,14 @@ function getSampleSkills(): SkillSummary[] {
verified: true,
},
{
name: 'security-best-practices',
description: 'Security patterns for web applications including XSS prevention, CSRF, and secure headers',
source: 'built-in',
tags: ['security', 'xss', 'csrf', 'headers', 'owasp'],
name: "security-best-practices",
description:
"Security patterns for web applications including XSS prevention, CSRF, and secure headers",
source: "built-in",
tags: ["security", "xss", "csrf", "headers", "owasp"],
compatibility: {
frameworks: [],
languages: ['typescript', 'javascript', 'python'],
languages: ["typescript", "javascript", "python"],
libraries: [],
},
popularity: 600,
@@ -256,14 +298,15 @@ function getSampleSkills(): SkillSummary[] {
verified: true,
},
{
name: 'testing-patterns',
description: 'Testing patterns with Vitest/Jest including mocking, assertions, and test organization',
source: 'built-in',
tags: ['vitest', 'jest', 'testing', 'typescript', 'mocking', 'tdd'],
name: "testing-patterns",
description:
"Testing patterns with Vitest/Jest including mocking, assertions, and test organization",
source: "built-in",
tags: ["vitest", "jest", "testing", "typescript", "mocking", "tdd"],
compatibility: {
frameworks: [],
languages: ['typescript', 'javascript'],
libraries: ['vitest', 'jest'],
languages: ["typescript", "javascript"],
libraries: ["vitest", "jest"],
},
popularity: 700,
quality: 86,
+2 -2
View File
@@ -125,13 +125,13 @@ export function formatSarif(result: ScanResult): string {
driver: {
name: 'skillkit-scanner',
version: SCANNER_VERSION,
informationUri: 'https://agenstskills.com',
informationUri: 'https://skillkit.sh',
rules: [...rules.values()].map((r) => ({
id: r.ruleId,
name: r.ruleId,
shortDescription: { text: r.title },
fullDescription: { text: r.description },
helpUri: 'https://agenstskills.com/docs/security',
helpUri: 'https://skillkit.sh/docs/security',
defaultConfiguration: {
level: severityToSarif[r.severity] ?? 'warning',
},
@@ -0,0 +1,361 @@
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import { mkdirSync, writeFileSync, rmSync, existsSync } from 'node:fs';
import { join } from 'node:path';
import { stringify } from 'yaml';
import { SessionHandoff } from '../handoff.js';
import type { SessionState } from '../types.js';
const TEST_DIR = join(process.cwd(), '.test-handoff-' + process.pid);
const SKILLKIT_DIR = join(TEST_DIR, '.skillkit');
function writeSessionState(state: SessionState): void {
mkdirSync(SKILLKIT_DIR, { recursive: true });
writeFileSync(join(SKILLKIT_DIR, 'session.yaml'), stringify(state));
}
function writeObservations(observations: Array<Record<string, unknown>>): void {
const dir = join(SKILLKIT_DIR, 'memory');
mkdirSync(dir, { recursive: true });
writeFileSync(
join(dir, 'observations.yaml'),
stringify({ version: 1, sessionId: 'test', observations })
);
}
beforeEach(() => {
mkdirSync(TEST_DIR, { recursive: true });
});
afterEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true });
}
});
describe('SessionHandoff', () => {
it('should create handoff instance', () => {
const handoff = new SessionHandoff(TEST_DIR);
expect(handoff).toBeDefined();
});
it('should generate empty handoff when no data', () => {
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.generatedAt).toBeTruthy();
expect(doc.projectPath).toBe(TEST_DIR);
expect(doc.accomplished.tasks).toEqual([]);
expect(doc.pending.tasks).toEqual([]);
expect(doc.keyFiles).toEqual([]);
});
it('should collect accomplished tasks', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
currentExecution: {
skillName: 'test-skill',
skillSource: 'test',
currentStep: 2,
totalSteps: 3,
status: 'running',
startedAt: '2026-02-12T10:00:00.000Z',
tasks: [
{
id: 't1',
name: 'Setup project',
type: 'auto',
status: 'completed',
startedAt: '2026-02-12T10:00:00.000Z',
completedAt: '2026-02-12T10:03:00.000Z',
commitSha: 'abc1234',
},
{
id: 't2',
name: 'Write tests',
type: 'auto',
status: 'completed',
startedAt: '2026-02-12T10:03:00.000Z',
completedAt: '2026-02-12T10:08:00.000Z',
},
{
id: 't3',
name: 'Update docs',
type: 'auto',
status: 'pending',
},
],
},
});
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.accomplished.tasks.length).toBe(2);
expect(doc.accomplished.tasks[0].name).toBe('Setup project');
expect(doc.accomplished.tasks[0].duration).toBe('3m');
expect(doc.accomplished.tasks[0].commitSha).toBe('abc1234');
});
it('should collect pending tasks', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
currentExecution: {
skillName: 'test-skill',
skillSource: 'test',
currentStep: 0,
totalSteps: 2,
status: 'running',
startedAt: '2026-02-12T10:00:00.000Z',
tasks: [
{ id: 't1', name: 'Pending task', type: 'auto', status: 'pending' },
{ id: 't2', name: 'In progress task', type: 'auto', status: 'in_progress', startedAt: '2026-02-12T10:00:00.000Z' },
],
},
});
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.pending.tasks.length).toBe(2);
expect(doc.pending.tasks[0].name).toBe('Pending task');
expect(doc.pending.tasks[1].name).toBe('In progress task');
});
it('should collect key files from tasks and history', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'old-skill',
skillSource: 'test',
completedAt: '2026-02-11T15:00:00.000Z',
durationMs: 120000,
status: 'completed',
commits: [],
filesModified: ['src/old.ts', 'src/shared.ts'],
},
],
decisions: [],
currentExecution: {
skillName: 'test-skill',
skillSource: 'test',
currentStep: 1,
totalSteps: 1,
status: 'running',
startedAt: '2026-02-12T10:00:00.000Z',
tasks: [
{
id: 't1',
name: 'Task 1',
type: 'auto',
status: 'completed',
filesModified: ['src/new.ts', 'src/shared.ts'],
},
],
},
});
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.keyFiles.length).toBe(3);
const paths = doc.keyFiles.map((f) => f.path);
expect(paths).toContain('src/new.ts');
expect(paths).toContain('src/old.ts');
expect(paths).toContain('src/shared.ts');
});
it('should collect observations by type', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
});
writeObservations([
{
id: 'o1',
timestamp: '2026-02-12T10:00:00.000Z',
sessionId: 'test',
agent: 'claude-code',
type: 'error',
content: { action: 'build', context: 'src', error: 'missing import' },
relevance: 90,
},
{
id: 'o2',
timestamp: '2026-02-12T10:01:00.000Z',
sessionId: 'test',
agent: 'claude-code',
type: 'solution',
content: { action: 'fix', context: 'src', solution: 'added import' },
relevance: 85,
},
{
id: 'o3',
timestamp: '2026-02-12T10:02:00.000Z',
sessionId: 'test',
agent: 'claude-code',
type: 'pattern',
content: { action: 'review', context: 'always check imports' },
relevance: 70,
},
]);
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.observations.errors.length).toBe(1);
expect(doc.observations.errors[0].error).toBe('missing import');
expect(doc.observations.solutions.length).toBe(1);
expect(doc.observations.solutions[0].solution).toBe('added import');
expect(doc.observations.patterns.length).toBe(1);
});
it('should generate recommendations from pending tasks', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
currentExecution: {
skillName: 'test-skill',
skillSource: 'test',
currentStep: 0,
totalSteps: 1,
status: 'running',
startedAt: '2026-02-12T10:00:00.000Z',
tasks: [
{ id: 't1', name: 'Write documentation', type: 'auto', status: 'pending' },
],
},
});
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.recommendations.length).toBeGreaterThan(0);
expect(doc.recommendations[0]).toContain('Write documentation');
});
it('should format markdown output', () => {
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
const md = handoff.toMarkdown(doc);
expect(md).toContain('# Session Handoff');
expect(md).toContain('## Accomplished');
expect(md).toContain('## Pending');
});
it('should format JSON output', () => {
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
const json = handoff.toJson(doc);
const parsed = JSON.parse(json);
expect(parsed.projectPath).toBe(TEST_DIR);
expect(parsed.accomplished).toBeDefined();
expect(parsed.pending).toBeDefined();
});
it('should include history in accomplished', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'completed-skill',
skillSource: 'test',
completedAt: '2026-02-12T09:00:00.000Z',
durationMs: 300000,
status: 'completed',
commits: ['def5678'],
filesModified: ['src/foo.ts'],
},
],
decisions: [],
});
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false });
expect(doc.accomplished.tasks.length).toBe(1);
expect(doc.accomplished.tasks[0].name).toBe('completed-skill');
expect(doc.accomplished.tasks[0].duration).toBe('5m');
});
it('should respect maxObservations option', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
});
writeObservations(
Array.from({ length: 10 }, (_, i) => ({
id: `o${i}`,
timestamp: `2026-02-12T10:${String(i).padStart(2, '0')}:00.000Z`,
sessionId: 'test',
agent: 'claude-code',
type: 'error',
content: { action: `action-${i}`, context: 'src', error: `error-${i}` },
relevance: 90 - i,
}))
);
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false, maxObservations: 3 });
const totalObs =
doc.observations.errors.length +
doc.observations.solutions.length +
doc.observations.patterns.length;
expect(totalObs).toBeLessThanOrEqual(3);
});
it('should skip observations when disabled', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
});
writeObservations([
{
id: 'o1',
timestamp: '2026-02-12T10:00:00.000Z',
sessionId: 'test',
agent: 'claude-code',
type: 'error',
content: { action: 'build', context: 'src', error: 'fail' },
relevance: 90,
},
]);
const handoff = new SessionHandoff(TEST_DIR);
const doc = handoff.generate({ includeGit: false, includeObservations: false });
expect(doc.observations.errors).toEqual([]);
expect(doc.observations.solutions).toEqual([]);
expect(doc.observations.patterns).toEqual([]);
});
});
@@ -0,0 +1,554 @@
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import { mkdirSync, writeFileSync, rmSync, existsSync } from 'node:fs';
import { join } from 'node:path';
import { stringify } from 'yaml';
import { SkillLineage } from '../lineage.js';
import type { SessionState } from '../types.js';
const TEST_DIR = join(process.cwd(), '.test-lineage-' + process.pid);
const SKILLKIT_DIR = join(TEST_DIR, '.skillkit');
function writeSessionState(state: SessionState): void {
mkdirSync(SKILLKIT_DIR, { recursive: true });
writeFileSync(join(SKILLKIT_DIR, 'session.yaml'), stringify(state));
}
function writeActivityLog(activities: Array<Record<string, unknown>>): void {
mkdirSync(SKILLKIT_DIR, { recursive: true });
writeFileSync(
join(SKILLKIT_DIR, 'activity.yaml'),
stringify({ version: 1, activities })
);
}
function writeObservations(observations: Array<Record<string, unknown>>): void {
const dir = join(SKILLKIT_DIR, 'memory');
mkdirSync(dir, { recursive: true });
writeFileSync(
join(dir, 'observations.yaml'),
stringify({ version: 1, sessionId: 'test', observations })
);
}
beforeEach(() => {
mkdirSync(TEST_DIR, { recursive: true });
});
afterEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true });
}
});
describe('SkillLineage', () => {
it('should create lineage instance', () => {
const lineage = new SkillLineage(TEST_DIR);
expect(lineage).toBeDefined();
});
it('should return empty lineage when no data', () => {
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
expect(data.skills).toEqual([]);
expect(data.files).toEqual([]);
expect(data.stats.totalSkillExecutions).toBe(0);
expect(data.stats.mostImpactfulSkill).toBeNull();
});
it('should build lineage from execution history', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'code-simplifier',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 120000,
status: 'completed',
commits: ['abc1234', 'def5678'],
filesModified: ['src/index.ts', 'src/utils.ts'],
},
{
skillName: 'code-simplifier',
skillSource: 'test',
completedAt: '2026-02-12T11:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['ghi9012'],
filesModified: ['src/index.ts'],
},
{
skillName: 'pro-workflow',
skillSource: 'test',
completedAt: '2026-02-12T12:00:00.000Z',
durationMs: 180000,
status: 'completed',
commits: ['jkl3456'],
filesModified: ['src/index.ts', 'README.md'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
expect(data.skills.length).toBe(2);
const cs = data.skills.find((s) => s.skillName === 'code-simplifier');
expect(cs).toBeDefined();
expect(cs!.executions).toBe(2);
expect(cs!.totalDurationMs).toBe(180000);
expect(cs!.commits.length).toBe(3);
expect(cs!.filesModified).toContain('src/index.ts');
expect(cs!.filesModified).toContain('src/utils.ts');
const pw = data.skills.find((s) => s.skillName === 'pro-workflow');
expect(pw).toBeDefined();
expect(pw!.executions).toBe(1);
});
it('should build file lineage', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'skill-a',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['abc'],
filesModified: ['src/shared.ts'],
},
{
skillName: 'skill-b',
skillSource: 'test',
completedAt: '2026-02-12T11:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['def'],
filesModified: ['src/shared.ts', 'src/only-b.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
const shared = data.files.find((f) => f.path === 'src/shared.ts');
expect(shared).toBeDefined();
expect(shared!.skills.length).toBe(2);
expect(shared!.skills).toContain('skill-a');
expect(shared!.skills).toContain('skill-b');
});
it('should compute stats', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'big-skill',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['a', 'b'],
filesModified: ['f1.ts', 'f2.ts', 'f3.ts'],
},
{
skillName: 'small-skill',
skillSource: 'test',
completedAt: '2026-02-12T11:00:00.000Z',
durationMs: 30000,
status: 'completed',
commits: ['c'],
filesModified: ['f1.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
expect(data.stats.totalSkillExecutions).toBe(2);
expect(data.stats.totalCommits).toBe(3);
expect(data.stats.totalFilesChanged).toBe(3);
expect(data.stats.mostImpactfulSkill).toBe('big-skill');
});
it('should filter by skill name', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'target',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['a'],
filesModified: ['src/a.ts'],
},
{
skillName: 'other',
skillSource: 'test',
completedAt: '2026-02-12T11:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['b'],
filesModified: ['src/b.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build({ skill: 'target' });
expect(data.skills.length).toBe(1);
expect(data.skills[0].skillName).toBe('target');
expect(data.files.every((f) => f.skills.includes('target'))).toBe(true);
});
it('should filter by file path', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'skill-a',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['a'],
filesModified: ['src/target.ts', 'src/other.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build({ file: 'target.ts' });
expect(data.files.length).toBe(1);
expect(data.files[0].path).toBe('src/target.ts');
});
it('should filter by since date', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'old',
skillSource: 'test',
completedAt: '2026-01-01T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['a'],
filesModified: ['old.ts'],
},
{
skillName: 'recent',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['b'],
filesModified: ['recent.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build({ since: '2026-02-01' });
expect(data.skills.length).toBe(1);
expect(data.skills[0].skillName).toBe('recent');
});
it('should include current execution in lineage', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
currentExecution: {
skillName: 'active-skill',
skillSource: 'test',
currentStep: 1,
totalSteps: 2,
status: 'running',
startedAt: '2026-02-12T10:00:00.000Z',
tasks: [
{
id: 't1',
name: 'Task 1',
type: 'auto',
status: 'completed',
commitSha: 'abc',
filesModified: ['src/active.ts'],
},
],
},
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
expect(data.skills.length).toBe(1);
expect(data.skills[0].skillName).toBe('active-skill');
expect(data.skills[0].commits).toContain('abc');
expect(data.skills[0].filesModified).toContain('src/active.ts');
});
it('should merge activity log data', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'my-skill',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['abc'],
filesModified: ['src/a.ts'],
},
],
decisions: [],
});
writeActivityLog([
{
commitSha: 'xyz',
committedAt: '2026-02-12T11:00:00.000Z',
activeSkills: ['my-skill'],
filesChanged: ['src/b.ts'],
message: 'extra commit',
},
]);
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
const skill = data.skills.find((s) => s.skillName === 'my-skill');
expect(skill).toBeDefined();
expect(skill!.commits).toContain('xyz');
});
it('should match observations by timestamp overlap', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'test-skill',
skillSource: 'test',
completedAt: '2026-02-12T11:00:00.000Z',
durationMs: 3600000,
status: 'completed',
commits: [],
filesModified: [],
},
],
decisions: [],
});
writeObservations([
{
id: 'obs1',
timestamp: '2026-02-12T10:30:00.000Z',
sessionId: 'test',
agent: 'claude-code',
type: 'error',
content: { action: 'build', context: 'src', files: ['src/buggy.ts'] },
relevance: 80,
},
]);
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
expect(data.stats.errorProneFiles).toContain('src/buggy.ts');
});
it('should getSkillLineage for a specific skill', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'target-skill',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['abc'],
filesModified: ['src/foo.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const entry = lineage.getSkillLineage('target-skill');
expect(entry).toBeDefined();
expect(entry!.skillName).toBe('target-skill');
expect(entry!.executions).toBe(1);
});
it('should getFileLineage for a specific file', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'skill-a',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['abc'],
filesModified: ['src/target.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const fl = lineage.getFileLineage('src/target.ts');
expect(fl).toBeDefined();
expect(fl!.path).toBe('src/target.ts');
expect(fl!.skills).toContain('skill-a');
});
it('should format text output', () => {
const lineage = new SkillLineage(TEST_DIR);
const data = {
projectPath: TEST_DIR,
skills: [
{
skillName: 'test-skill',
executions: 3,
totalDurationMs: 180000,
commits: ['a', 'b'],
filesModified: ['f1.ts', 'f2.ts'],
observationIds: [],
firstSeen: '2026-02-12T08:00:00.000Z',
lastSeen: '2026-02-12T12:00:00.000Z',
},
],
files: [
{ path: 'f1.ts', skills: ['test-skill', 'other'], commitCount: 5, lastModified: '2026-02-12T12:00:00.000Z' },
],
stats: {
totalSkillExecutions: 3,
totalCommits: 2,
totalFilesChanged: 2,
mostImpactfulSkill: 'test-skill',
mostChangedFile: 'f1.ts',
errorProneFiles: ['f1.ts'],
},
};
const text = lineage.formatText(data);
expect(text).toContain('Skill Lineage');
expect(text).toContain('test-skill');
expect(text).toContain('3 runs');
expect(text).toContain('File Hotspots');
expect(text).toContain('Stats');
});
it('should format JSON output', () => {
const lineage = new SkillLineage(TEST_DIR);
const data = {
projectPath: TEST_DIR,
skills: [],
files: [],
stats: {
totalSkillExecutions: 0,
totalCommits: 0,
totalFilesChanged: 0,
mostImpactfulSkill: null,
mostChangedFile: null,
errorProneFiles: [],
},
};
const json = lineage.formatJson(data);
const parsed = JSON.parse(json);
expect(parsed.projectPath).toBe(TEST_DIR);
});
it('should handle empty lineage in text format', () => {
const lineage = new SkillLineage(TEST_DIR);
const data = {
projectPath: TEST_DIR,
skills: [],
files: [],
stats: {
totalSkillExecutions: 0,
totalCommits: 0,
totalFilesChanged: 0,
mostImpactfulSkill: null,
mostChangedFile: null,
errorProneFiles: [],
},
};
const text = lineage.formatText(data);
expect(text).toContain('No skill executions found');
});
it('should deduplicate commits and files', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'dup-skill',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: ['abc', 'abc'],
filesModified: ['src/a.ts', 'src/a.ts', 'src/b.ts'],
},
],
decisions: [],
});
const lineage = new SkillLineage(TEST_DIR);
const data = lineage.build();
const skill = data.skills.find((s) => s.skillName === 'dup-skill');
expect(skill!.commits.length).toBe(1);
expect(skill!.filesModified.length).toBe(2);
});
});
@@ -0,0 +1,423 @@
import { describe, it, expect, beforeEach, afterEach } from 'vitest';
import { mkdirSync, writeFileSync, rmSync, existsSync } from 'node:fs';
import { join } from 'node:path';
import { stringify } from 'yaml';
import { SessionTimeline } from '../timeline.js';
import type { SessionState, TimelineOptions } from '../types.js';
const TEST_DIR = join(process.cwd(), '.test-timeline-' + process.pid);
const SKILLKIT_DIR = join(TEST_DIR, '.skillkit');
function writeSessionState(state: SessionState): void {
mkdirSync(SKILLKIT_DIR, { recursive: true });
writeFileSync(join(SKILLKIT_DIR, 'session.yaml'), stringify(state));
}
function writeObservations(observations: Array<Record<string, unknown>>): void {
const dir = join(SKILLKIT_DIR, 'memory');
mkdirSync(dir, { recursive: true });
writeFileSync(
join(dir, 'observations.yaml'),
stringify({ version: 1, sessionId: 'test', observations })
);
}
function writeSnapshots(snapshots: Array<Record<string, unknown>>): void {
const dir = join(SKILLKIT_DIR, 'snapshots');
mkdirSync(dir, { recursive: true });
for (const snap of snapshots) {
writeFileSync(join(dir, `${snap.name}.yaml`), stringify(snap));
}
}
beforeEach(() => {
mkdirSync(TEST_DIR, { recursive: true });
});
afterEach(() => {
if (existsSync(TEST_DIR)) {
rmSync(TEST_DIR, { recursive: true, force: true });
}
});
describe('SessionTimeline', () => {
it('should create timeline instance', () => {
const timeline = new SessionTimeline(TEST_DIR);
expect(timeline).toBeDefined();
});
it('should return empty timeline when no data', () => {
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build();
expect(data.events).toEqual([]);
expect(data.totalCount).toBe(0);
expect(data.projectPath).toBe(TEST_DIR);
});
it('should collect events from current execution', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
currentExecution: {
skillName: 'test-skill',
skillSource: 'test',
currentStep: 1,
totalSteps: 2,
status: 'running',
startedAt: '2026-02-12T10:00:00.000Z',
tasks: [
{
id: 't1',
name: 'Task 1',
type: 'auto',
status: 'completed',
startedAt: '2026-02-12T10:00:00.000Z',
completedAt: '2026-02-12T10:01:00.000Z',
},
{
id: 't2',
name: 'Task 2',
type: 'auto',
status: 'in_progress',
startedAt: '2026-02-12T10:01:00.000Z',
},
],
},
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ includeGit: false });
const skillStarts = data.events.filter((e) => e.type === 'skill_start');
expect(skillStarts.length).toBe(1);
expect(skillStarts[0].source).toBe('test-skill');
const taskEvents = data.events.filter((e) => e.type === 'task_progress');
expect(taskEvents.length).toBe(2);
});
it('should collect events from execution history', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'old-skill',
skillSource: 'test',
completedAt: '2026-02-11T15:00:00.000Z',
durationMs: 120000,
status: 'completed',
commits: ['abc1234'],
filesModified: ['src/index.ts'],
},
],
decisions: [],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ includeGit: false });
const completes = data.events.filter((e) => e.type === 'skill_complete');
expect(completes.length).toBe(1);
expect(completes[0].summary).toContain('old-skill');
expect(completes[0].summary).toContain('2m');
});
it('should collect decision events', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [
{
key: 'api-style',
value: 'REST',
madeAt: '2026-02-12T11:00:00.000Z',
skillName: 'architect',
},
],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ includeGit: false });
const decisions = data.events.filter((e) => e.type === 'decision');
expect(decisions.length).toBe(1);
expect(decisions[0].summary).toContain('REST');
});
it('should collect observation events', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
});
writeObservations([
{
id: 'obs1',
timestamp: '2026-02-12T10:30:00.000Z',
sessionId: 'test',
agent: 'claude-code',
type: 'error',
content: { action: 'build', context: 'src', error: 'missing import' },
relevance: 80,
},
]);
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ includeGit: false });
const obs = data.events.filter((e) => e.type === 'observation');
expect(obs.length).toBe(1);
expect(obs[0].summary).toContain('error');
});
it('should collect snapshot events', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [],
decisions: [],
});
writeSnapshots([
{
version: 1,
name: 'pre-refactor',
createdAt: '2026-02-12T09:00:00.000Z',
description: 'Before big refactor',
sessionState: {
version: 1,
lastActivity: '2026-02-12T09:00:00.000Z',
projectPath: TEST_DIR,
history: [],
decisions: [],
},
observations: [],
},
]);
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ includeGit: false });
const snaps = data.events.filter((e) => e.type === 'snapshot');
expect(snaps.length).toBe(1);
expect(snaps[0].summary).toContain('pre-refactor');
});
it('should filter by event type', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'skill-a',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
],
decisions: [
{ key: 'k', value: 'v', madeAt: '2026-02-12T10:01:00.000Z' },
],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ types: ['decision'], includeGit: false });
expect(data.events.every((e) => e.type === 'decision')).toBe(true);
expect(data.events.length).toBe(1);
});
it('should filter by since date', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'old',
skillSource: 'test',
completedAt: '2026-02-01T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
{
skillName: 'recent',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
],
decisions: [],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ since: '2026-02-10', includeGit: false });
expect(data.events.length).toBe(1);
expect(data.events[0].source).toBe('recent');
});
it('should respect limit', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: Array.from({ length: 10 }, (_, i) => ({
skillName: `skill-${i}`,
skillSource: 'test',
completedAt: `2026-02-12T${String(i).padStart(2, '0')}:00:00.000Z`,
durationMs: 60000,
status: 'completed' as const,
commits: [],
filesModified: [],
})),
decisions: [],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ limit: 3, includeGit: false });
expect(data.events.length).toBe(3);
expect(data.totalCount).toBe(10);
});
it('should sort events chronologically', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'later',
skillSource: 'test',
completedAt: '2026-02-12T12:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
{
skillName: 'earlier',
skillSource: 'test',
completedAt: '2026-02-12T08:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
],
decisions: [],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ includeGit: false });
expect(data.events[0].source).toBe('earlier');
expect(data.events[1].source).toBe('later');
});
it('should format text output', () => {
const timeline = new SessionTimeline(TEST_DIR);
const data = {
projectPath: TEST_DIR,
sessionDate: '2026-02-12',
events: [
{
timestamp: '2026-02-12T10:30:00.000Z',
type: 'skill_start' as const,
source: 'test-skill',
summary: 'test-skill started',
},
],
totalCount: 1,
};
const text = timeline.formatText(data);
expect(text).toContain('Session Timeline');
expect(text).toContain('test-skill started');
expect(text).toContain('1 event total');
});
it('should format JSON output', () => {
const timeline = new SessionTimeline(TEST_DIR);
const data = {
projectPath: TEST_DIR,
sessionDate: '2026-02-12',
events: [],
totalCount: 0,
};
const json = timeline.formatJson(data);
const parsed = JSON.parse(json);
expect(parsed.projectPath).toBe(TEST_DIR);
expect(parsed.events).toEqual([]);
});
it('should filter by skill name', () => {
writeSessionState({
version: 1,
lastActivity: new Date().toISOString(),
projectPath: TEST_DIR,
history: [
{
skillName: 'target-skill',
skillSource: 'test',
completedAt: '2026-02-12T10:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
{
skillName: 'other-skill',
skillSource: 'test',
completedAt: '2026-02-12T11:00:00.000Z',
durationMs: 60000,
status: 'completed',
commits: [],
filesModified: [],
},
],
decisions: [],
});
const timeline = new SessionTimeline(TEST_DIR);
const data = timeline.build({ skillFilter: 'target-skill', includeGit: false });
expect(data.events.length).toBe(1);
expect(data.events[0].source).toBe('target-skill');
});
it('should handle empty events in text format', () => {
const timeline = new SessionTimeline(TEST_DIR);
const data = {
projectPath: TEST_DIR,
sessionDate: '2026-02-12',
events: [],
totalCount: 0,
};
const text = timeline.formatText(data);
expect(text).toContain('No events found');
});
});
+314
View File
@@ -0,0 +1,314 @@
import { SessionManager } from './manager.js';
import { ActivityLog } from './activity-log.js';
import { ObservationStore } from '../memory/observation-store.js';
import { getGitCommits } from '../learning/git-analyzer.js';
import { loadConfig } from '../config.js';
import type {
HandoffDocument,
HandoffSection,
HandoffOptions,
SessionTask,
ExecutionHistory,
} from './types.js';
function formatDuration(ms: number): string {
const seconds = Math.floor(ms / 1000);
const minutes = Math.floor(seconds / 60);
const hours = Math.floor(minutes / 60);
if (hours > 0) return `${hours}h ${minutes % 60}m`;
if (minutes > 0) return `${minutes}m`;
return `${seconds}s`;
}
export class SessionHandoff {
private readonly projectPath: string;
private readonly sessionManager: SessionManager;
private readonly activityLog: ActivityLog;
constructor(projectPath: string) {
this.projectPath = projectPath;
this.sessionManager = new SessionManager(projectPath);
this.activityLog = new ActivityLog(projectPath);
}
generate(options?: HandoffOptions): HandoffDocument {
const state = this.sessionManager.get();
const includeGit = options?.includeGit !== false;
const includeObservations = options?.includeObservations !== false;
const maxObservations = options?.maxObservations ?? 20;
let agent = 'unknown';
try {
const configAgent = loadConfig().agent;
if (configAgent && configAgent !== 'universal') {
agent = configAgent;
}
} catch {
// use default
}
if (agent === 'unknown' && state?.currentExecution?.skillSource) {
agent = state.currentExecution.skillSource;
}
const accomplished = this.buildAccomplished(state?.currentExecution?.tasks, state?.history ?? [], includeGit);
const pending = this.buildPending(state?.currentExecution?.tasks);
const keyFiles = this.buildKeyFiles(state?.currentExecution?.tasks, state?.history ?? []);
const observations = includeObservations
? this.buildObservations(maxObservations)
: { errors: [], solutions: [], patterns: [] };
const recommendations = this.buildRecommendations(pending, observations, includeGit);
return {
generatedAt: new Date().toISOString(),
fromAgent: agent,
projectPath: this.projectPath,
accomplished,
pending,
keyFiles,
observations,
recommendations,
};
}
private buildAccomplished(
tasks: SessionTask[] | undefined,
history: ExecutionHistory[],
includeGit: boolean
): HandoffSection {
const section: HandoffSection = { tasks: [], commits: [] };
for (const task of tasks ?? []) {
if (task.status === 'completed') {
let duration: string | undefined;
if (task.startedAt && task.completedAt) {
duration = formatDuration(
new Date(task.completedAt).getTime() - new Date(task.startedAt).getTime()
);
}
section.tasks.push({
name: task.name,
duration,
commitSha: task.commitSha,
});
}
}
for (const hist of history) {
if (hist.status === 'completed') {
section.tasks.push({
name: hist.skillName,
duration: Number.isFinite(hist.durationMs) ? formatDuration(hist.durationMs) : undefined,
commitSha: hist.commits?.[0],
});
}
}
if (includeGit) {
try {
const today = new Date().toISOString().split('T')[0];
const commits = getGitCommits(this.projectPath, { commits: 50 });
for (const commit of commits) {
if (commit.date.startsWith(today)) {
section.commits.push({
sha: commit.shortHash,
message: commit.message,
filesCount: commit.files.length,
});
}
}
} catch {
// git not available
}
}
return section;
}
private buildPending(tasks: SessionTask[] | undefined): HandoffSection {
const section: HandoffSection = { tasks: [], commits: [] };
const pendingStatuses = new Set(['pending', 'in_progress', 'paused']);
for (const task of tasks ?? []) {
if (pendingStatuses.has(task.status)) {
section.tasks.push({ name: task.name });
}
}
return section;
}
private buildKeyFiles(
tasks: SessionTask[] | undefined,
history: ExecutionHistory[]
): Array<{ path: string; changeType: string }> {
const fileMap = new Map<string, string>();
for (const task of tasks ?? []) {
for (const f of task.filesModified ?? []) {
fileMap.set(f, task.status === 'completed' ? 'modified' : 'in-progress');
}
}
for (const hist of history) {
for (const f of hist.filesModified ?? []) {
if (!fileMap.has(f)) {
fileMap.set(f, 'modified');
}
}
}
return Array.from(fileMap.entries())
.map(([path, changeType]) => ({ path, changeType }))
.sort((a, b) => a.path.localeCompare(b.path));
}
private buildObservations(max: number): HandoffDocument['observations'] {
const result: HandoffDocument['observations'] = {
errors: [],
solutions: [],
patterns: [],
};
try {
const observations = ObservationStore.readAll(this.projectPath);
const sorted = [...observations].sort((a, b) => b.relevance - a.relevance);
let count = 0;
for (const obs of sorted) {
if (count >= max) break;
if (obs.type === 'error' && obs.content.error) {
result.errors.push({ action: obs.content.action, error: obs.content.error });
count++;
} else if (obs.type === 'solution' && obs.content.solution) {
result.solutions.push({ action: obs.content.action, solution: obs.content.solution });
count++;
} else if (obs.type === 'pattern' && obs.content.context) {
result.patterns.push({ action: obs.content.action, context: obs.content.context });
count++;
}
}
} catch {
// no observations
}
return result;
}
private buildRecommendations(
pending: HandoffSection,
observations: HandoffDocument['observations'],
includeGit: boolean
): string[] {
const recs: string[] = [];
if (pending.tasks.length > 0) {
recs.push(`Complete pending tasks: ${pending.tasks.map((t) => t.name).join(', ')}`);
}
if (observations.errors.length > 0) {
const unresolved = observations.errors.filter(
(e) => !observations.solutions.some((s) => s.action === e.action)
);
if (unresolved.length > 0) {
recs.push(`Resolve ${unresolved.length} unresolved error(s)`);
}
}
if (includeGit) {
try {
const activities = this.activityLog.getRecent(50);
const fileCounts = new Map<string, number>();
for (const activity of activities) {
for (const f of activity.filesChanged) {
fileCounts.set(f, (fileCounts.get(f) ?? 0) + 1);
}
}
const highChurn = Array.from(fileCounts.entries())
.filter(([, count]) => count >= 3)
.sort((a, b) => b[1] - a[1])
.slice(0, 3);
for (const [file, count] of highChurn) {
recs.push(`Review high-churn file: ${file} (${count} changes)`);
}
} catch {
// activity log not available
}
}
return recs;
}
toMarkdown(doc: HandoffDocument): string {
const lines: string[] = [];
lines.push(`# Session Handoff`);
lines.push(`Agent: ${doc.fromAgent} | ${doc.generatedAt.split('T')[0]}\n`);
lines.push(`## Accomplished`);
if (doc.accomplished.tasks.length === 0 && doc.accomplished.commits.length === 0) {
lines.push('No completed tasks.\n');
} else {
for (const task of doc.accomplished.tasks) {
const dur = task.duration ? ` (${task.duration})` : '';
const sha = task.commitSha ? ` [${task.commitSha.slice(0, 7)}]` : '';
lines.push(`- ${task.name}${dur}${sha}`);
}
for (const commit of doc.accomplished.commits) {
lines.push(`- ${commit.sha} — ${commit.message} (${commit.filesCount} files)`);
}
lines.push('');
}
lines.push(`## Pending`);
if (doc.pending.tasks.length === 0) {
lines.push('No pending tasks.\n');
} else {
for (const task of doc.pending.tasks) {
lines.push(`- ${task.name}`);
}
lines.push('');
}
if (doc.keyFiles.length > 0) {
lines.push(`## Key Files`);
for (const f of doc.keyFiles) {
lines.push(`- \`${f.path}\` (${f.changeType})`);
}
lines.push('');
}
const hasObs =
doc.observations.errors.length > 0 ||
doc.observations.solutions.length > 0 ||
doc.observations.patterns.length > 0;
if (hasObs) {
lines.push(`## Observations`);
for (const e of doc.observations.errors) {
lines.push(`- Error: ${e.error} (${e.action})`);
}
for (const s of doc.observations.solutions) {
lines.push(`- Solution: ${s.solution} (${s.action})`);
}
for (const p of doc.observations.patterns) {
lines.push(`- Pattern: ${p.action} — ${p.context}`);
}
lines.push('');
}
if (doc.recommendations.length > 0) {
lines.push(`## Recommendations`);
doc.recommendations.forEach((r, i) => {
lines.push(`${i + 1}. ${r}`);
});
lines.push('');
}
return lines.join('\n');
}
toJson(doc: HandoffDocument): string {
return JSON.stringify(doc, null, 2);
}
}
+3
View File
@@ -11,3 +11,6 @@ export { SessionManager, createSessionManager } from './manager.js';
export { ActivityLog } from './activity-log.js';
export { SnapshotManager } from './snapshot-manager.js';
export { SessionExplainer } from './session-explainer.js';
export { SessionTimeline } from './timeline.js';
export { SessionHandoff } from './handoff.js';
export { SkillLineage } from './lineage.js';
+288
View File
@@ -0,0 +1,288 @@
import { SessionManager } from './manager.js';
import { ActivityLog } from './activity-log.js';
import { ObservationStore } from '../memory/observation-store.js';
import type {
SkillLineageEntry,
FileLineage,
LineageData,
LineageOptions,
} from './types.js';
function formatDurationMs(ms: number): string {
const seconds = Math.floor(ms / 1000);
const minutes = Math.floor(seconds / 60);
const hours = Math.floor(minutes / 60);
if (hours > 0) return `${hours}h ${minutes % 60}m`;
if (minutes > 0) return `${minutes}m`;
return `${seconds}s`;
}
export class SkillLineage {
private readonly projectPath: string;
private readonly sessionManager: SessionManager;
private readonly activityLog: ActivityLog;
constructor(projectPath: string) {
this.projectPath = projectPath;
this.sessionManager = new SessionManager(projectPath);
this.activityLog = new ActivityLog(projectPath);
}
build(options?: LineageOptions): LineageData {
const state = this.sessionManager.get();
const sinceDate = options?.since ? new Date(options.since) : undefined;
const skillMap = new Map<string, SkillLineageEntry>();
const fileSkillMap = new Map<string, Set<string>>();
const fileCommitCount = new Map<string, number>();
const fileLastModified = new Map<string, string>();
for (const hist of state?.history ?? []) {
if (sinceDate && new Date(hist.completedAt) < sinceDate) continue;
const entry = skillMap.get(hist.skillName) ?? {
skillName: hist.skillName,
executions: 0,
totalDurationMs: 0,
commits: [],
filesModified: [],
observationIds: [],
firstSeen: hist.completedAt,
lastSeen: hist.completedAt,
};
entry.executions++;
entry.totalDurationMs += hist.durationMs;
entry.commits.push(...(hist.commits ?? []));
entry.filesModified.push(...(hist.filesModified ?? []));
if (new Date(hist.completedAt) < new Date(entry.firstSeen)) {
entry.firstSeen = hist.completedAt;
}
if (new Date(hist.completedAt) > new Date(entry.lastSeen)) {
entry.lastSeen = hist.completedAt;
}
skillMap.set(hist.skillName, entry);
for (const f of hist.filesModified ?? []) {
const skills = fileSkillMap.get(f) ?? new Set();
skills.add(hist.skillName);
fileSkillMap.set(f, skills);
fileCommitCount.set(f, (fileCommitCount.get(f) ?? 0) + (hist.commits?.length ?? 0));
const existing = fileLastModified.get(f);
if (!existing || new Date(hist.completedAt) > new Date(existing)) {
fileLastModified.set(f, hist.completedAt);
}
}
}
if (state?.currentExecution) {
const exec = state.currentExecution;
const startTime = new Date(exec.startedAt);
if (!sinceDate || startTime >= sinceDate) {
const entry = skillMap.get(exec.skillName) ?? {
skillName: exec.skillName,
executions: 0,
totalDurationMs: 0,
commits: [],
filesModified: [],
observationIds: [],
firstSeen: exec.startedAt,
lastSeen: exec.startedAt,
};
entry.executions++;
entry.totalDurationMs += Date.now() - startTime.getTime();
for (const task of exec.tasks) {
if (task.commitSha) entry.commits.push(task.commitSha);
entry.filesModified.push(...(task.filesModified ?? []));
for (const f of task.filesModified ?? []) {
const skills = fileSkillMap.get(f) ?? new Set();
skills.add(exec.skillName);
fileSkillMap.set(f, skills);
if (task.commitSha) {
fileCommitCount.set(f, (fileCommitCount.get(f) ?? 0) + 1);
}
const existing = fileLastModified.get(f);
if (!existing || new Date(exec.startedAt) > new Date(existing)) {
fileLastModified.set(f, exec.startedAt);
}
}
}
if (new Date(exec.startedAt) < new Date(entry.firstSeen)) {
entry.firstSeen = exec.startedAt;
}
entry.lastSeen = new Date().toISOString();
skillMap.set(exec.skillName, entry);
}
}
try {
const activities = this.activityLog.getRecent(500);
for (const activity of activities) {
if (sinceDate && new Date(activity.committedAt) < sinceDate) continue;
const countedFiles = new Set<string>();
for (const skill of activity.activeSkills) {
const entry = skillMap.get(skill);
if (entry && !entry.commits.includes(activity.commitSha)) {
entry.commits.push(activity.commitSha);
}
for (const f of activity.filesChanged) {
const skills = fileSkillMap.get(f) ?? new Set();
skills.add(skill);
fileSkillMap.set(f, skills);
if (!countedFiles.has(f)) {
fileCommitCount.set(f, (fileCommitCount.get(f) ?? 0) + 1);
countedFiles.add(f);
}
const existing = fileLastModified.get(f);
if (!existing || new Date(activity.committedAt) > new Date(existing)) {
fileLastModified.set(f, activity.committedAt);
}
}
}
}
} catch {
// activity log not available
}
const errorProneFiles: string[] = [];
try {
const observations = ObservationStore.readAll(this.projectPath);
for (const obs of observations) {
if (sinceDate && new Date(obs.timestamp) < sinceDate) continue;
for (const [, entry] of skillMap) {
const execStart = new Date(entry.firstSeen).getTime();
const execEnd = new Date(entry.lastSeen).getTime();
const obsTime = new Date(obs.timestamp).getTime();
if (obsTime >= execStart && obsTime <= execEnd) {
if (!entry.observationIds.includes(obs.id)) {
entry.observationIds.push(obs.id);
}
}
}
if (obs.type === 'error' && Array.isArray(obs.content?.files)) {
errorProneFiles.push(...obs.content.files);
}
}
} catch {
// no observations
}
for (const entry of skillMap.values()) {
entry.commits = [...new Set(entry.commits)];
entry.filesModified = [...new Set(entry.filesModified)];
}
let skills = Array.from(skillMap.values());
let files: FileLineage[] = Array.from(fileSkillMap.entries()).map(([path, skillSet]) => ({
path,
skills: Array.from(skillSet),
commitCount: fileCommitCount.get(path) ?? 0,
lastModified: fileLastModified.get(path) ?? '',
}));
if (options?.skill) {
skills = skills.filter((s) => s.skillName === options.skill);
const skillFiles = new Set(skills.flatMap((s) => s.filesModified));
files = files.filter((f) => skillFiles.has(f.path));
}
if (options?.file) {
files = files.filter((f) => f.path === options.file || f.path.includes(options.file!));
const fileSkills = new Set(files.flatMap((f) => f.skills));
skills = skills.filter((s) => fileSkills.has(s.skillName));
}
skills.sort((a, b) => b.filesModified.length - a.filesModified.length);
files.sort((a, b) => b.skills.length - a.skills.length || b.commitCount - a.commitCount);
if (options?.limit) {
skills = skills.slice(0, options.limit);
files = files.slice(0, options.limit);
}
const uniqueErrorFiles = [...new Set(errorProneFiles)];
const allCommits = new Set(skills.flatMap((s) => s.commits));
const allFiles = new Set(skills.flatMap((s) => s.filesModified));
const mostImpactful = skills.length > 0 ? skills[0].skillName : null;
const mostChanged = files.length > 0 ? files[0].path : null;
return {
projectPath: this.projectPath,
skills,
files,
stats: {
totalSkillExecutions: skills.reduce((sum, s) => sum + s.executions, 0),
totalCommits: allCommits.size,
totalFilesChanged: allFiles.size,
mostImpactfulSkill: mostImpactful,
mostChangedFile: mostChanged,
errorProneFiles: uniqueErrorFiles.slice(0, 5),
},
};
}
getSkillLineage(skillName: string): SkillLineageEntry | undefined {
const data = this.build({ skill: skillName });
return data.skills.find((s) => s.skillName === skillName);
}
getFileLineage(filePath: string): FileLineage | undefined {
const data = this.build({ file: filePath });
return data.files.find((f) => f.path === filePath || f.path.includes(filePath));
}
formatText(data: LineageData): string {
const lines: string[] = [];
lines.push(' Skill Lineage\n');
if (data.skills.length === 0) {
lines.push(' No skill executions found.\n');
return lines.join('\n');
}
lines.push(' Skills');
for (const skill of data.skills) {
const duration = formatDurationMs(skill.totalDurationMs);
lines.push(
` ${skill.skillName.padEnd(24)} ${skill.executions} runs ${skill.commits.length} commits ${skill.filesModified.length} files ${duration} total`
);
}
lines.push('');
const hotspots = data.files.filter((f) => f.skills.length >= 2);
if (hotspots.length > 0) {
lines.push(' File Hotspots (touched by 2+ skills)');
for (const f of hotspots.slice(0, 10)) {
lines.push(` ${f.path.padEnd(40)} ${f.skills.join(', ')}`);
}
lines.push('');
}
lines.push(' Stats');
lines.push(` Total executions: ${data.stats.totalSkillExecutions} | Commits: ${data.stats.totalCommits}`);
if (data.stats.mostImpactfulSkill) {
const skill = data.skills.find((s) => s.skillName === data.stats.mostImpactfulSkill);
lines.push(` Most impactful: ${data.stats.mostImpactfulSkill} (${skill?.filesModified.length ?? 0} files)`);
}
if (data.stats.errorProneFiles.length > 0) {
lines.push(` Error-prone: ${data.stats.errorProneFiles.join(', ')}`);
}
return lines.join('\n');
}
formatJson(data: LineageData): string {
return JSON.stringify(data, null, 2);
}
}
+231
View File
@@ -0,0 +1,231 @@
import { SessionManager } from './manager.js';
import { ActivityLog } from './activity-log.js';
import { SnapshotManager } from './snapshot-manager.js';
import { ObservationStore } from '../memory/observation-store.js';
import { getGitCommits } from '../learning/git-analyzer.js';
import type {
TimelineEvent,
TimelineData,
TimelineOptions,
TimelineEventType,
} from './types.js';
function formatDuration(ms: number): string {
const seconds = Math.floor(ms / 1000);
const minutes = Math.floor(seconds / 60);
const hours = Math.floor(minutes / 60);
if (hours > 0) return `${hours}h ${minutes % 60}m`;
if (minutes > 0) return `${minutes}m`;
return `${seconds}s`;
}
function formatTime(iso: string): string {
const d = new Date(iso);
if (isNaN(d.getTime())) return iso;
return d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
}
export class SessionTimeline {
private readonly projectPath: string;
private readonly sessionManager: SessionManager;
private readonly activityLog: ActivityLog;
private readonly snapshotManager: SnapshotManager;
constructor(projectPath: string) {
this.projectPath = projectPath;
this.sessionManager = new SessionManager(projectPath);
this.activityLog = new ActivityLog(projectPath);
this.snapshotManager = new SnapshotManager(projectPath);
}
build(options?: TimelineOptions): TimelineData {
const events: TimelineEvent[] = [];
const state = this.sessionManager.get();
const limit = options?.limit ?? 50;
const includeGit = options?.includeGit !== false;
const sinceDate = options?.since ? new Date(options.since) : undefined;
if (sinceDate && isNaN(sinceDate.getTime())) {
return { projectPath: this.projectPath, sessionDate: new Date().toISOString().split('T')[0], events: [], totalCount: 0 };
}
if (state?.currentExecution) {
const exec = state.currentExecution;
events.push({
timestamp: exec.startedAt,
type: 'skill_start',
source: exec.skillName,
summary: `${exec.skillName} started`,
details: { status: exec.status, totalSteps: exec.totalSteps },
});
const activeStatuses = new Set(['in_progress', 'completed', 'failed']);
for (const task of exec.tasks) {
if (task.startedAt && activeStatuses.has(task.status)) {
events.push({
timestamp: task.completedAt ?? task.startedAt,
type: 'task_progress',
source: exec.skillName,
summary: `${task.name} (${task.status})`,
details: { taskId: task.id, error: task.error },
});
}
}
}
for (const hist of state?.history ?? []) {
events.push({
timestamp: hist.completedAt,
type: 'skill_complete',
source: hist.skillName,
summary: `${hist.skillName} ${hist.status} (${formatDuration(hist.durationMs)})`,
details: {
durationMs: hist.durationMs,
commits: hist.commits,
filesModified: hist.filesModified,
},
});
}
if (includeGit) {
try {
const commits = getGitCommits(this.projectPath, {
commits: 50,
since: options?.since,
});
for (const commit of commits) {
const activity = this.activityLog.getByCommit(commit.shortHash);
events.push({
timestamp: commit.date,
type: 'git_commit',
source: activity?.activeSkills?.join(', ') ?? 'git',
summary: `${commit.shortHash} — ${commit.message} (${commit.files.length} files)`,
details: {
sha: commit.hash,
author: commit.author,
skills: activity?.activeSkills,
},
});
}
} catch {
// git not available
}
}
try {
const observations = ObservationStore.readAll(this.projectPath);
for (const obs of observations) {
events.push({
timestamp: obs.timestamp,
type: 'observation',
source: String(obs.agent),
summary: `${obs.type}: ${obs.content?.action ?? 'unknown'}`,
details: { observationId: obs.id, ...obs.content },
});
}
} catch {
// no observations
}
for (const decision of state?.decisions ?? []) {
events.push({
timestamp: decision.madeAt,
type: 'decision',
source: decision.skillName ?? 'user',
summary: `${decision.key} → ${decision.value}`,
});
}
try {
const snapshots = this.snapshotManager.list();
for (const snap of snapshots) {
events.push({
timestamp: snap.createdAt,
type: 'snapshot',
source: 'snapshot',
summary: `snapshot: ${snap.name}${snap.description ? ` — ${snap.description}` : ''}`,
details: { skillCount: snap.skillCount },
});
}
} catch {
// no snapshots
}
let filtered = events;
if (sinceDate) {
filtered = filtered.filter((e) => new Date(e.timestamp) >= sinceDate);
}
if (options?.types && options.types.length > 0) {
const typeSet = new Set<TimelineEventType>(options.types);
filtered = filtered.filter((e) => typeSet.has(e.type));
}
if (options?.skillFilter) {
const skill = options.skillFilter;
filtered = filtered.filter(
(e) => e.source.includes(skill) || (e.details?.skills as string[] | undefined)?.includes(skill)
);
}
filtered.sort((a, b) => new Date(a.timestamp).getTime() - new Date(b.timestamp).getTime());
const totalCount = filtered.length;
const limited = filtered.slice(-limit);
return {
projectPath: this.projectPath,
sessionDate: new Date().toISOString().split('T')[0],
events: limited,
totalCount,
};
}
formatText(data: TimelineData): string {
const lines: string[] = [];
lines.push(' Session Timeline\n');
if (data.events.length === 0) {
lines.push(' No events found.\n');
return lines.join('\n');
}
const icons: Record<TimelineEventType, string> = {
skill_start: '>',
skill_complete: '\u2713',
task_progress: '\u2022',
git_commit: '*',
observation: '!',
decision: '?',
snapshot: '\u25C9',
};
let lastTimeBlock = '';
for (const event of data.events) {
const time = formatTime(event.timestamp);
if (time !== lastTimeBlock) {
if (lastTimeBlock) lines.push('');
lines.push(` ${time}`);
lastTimeBlock = time;
}
const icon = icons[event.type] ?? '\u2022';
lines.push(` ${icon} ${event.summary}`);
}
lines.push('');
if (data.totalCount > data.events.length) {
lines.push(` Showing ${data.events.length} of ${data.totalCount} events`);
} else {
lines.push(` ${data.totalCount} ${data.totalCount === 1 ? 'event' : 'events'} total`);
}
return lines.join('\n');
}
formatJson(data: TimelineData): string {
return JSON.stringify(data, null, 2);
}
}
+94
View File
@@ -146,6 +146,100 @@ export interface SessionSnapshot {
}>;
}
// Timeline types
export type TimelineEventType = 'skill_start' | 'skill_complete' | 'task_progress' | 'git_commit' | 'observation' | 'decision' | 'snapshot';
export interface TimelineEvent {
timestamp: string;
type: TimelineEventType;
source: string;
summary: string;
details?: Record<string, unknown>;
}
export interface TimelineData {
projectPath: string;
sessionDate: string;
events: TimelineEvent[];
totalCount: number;
}
export interface TimelineOptions {
since?: string;
types?: TimelineEventType[];
limit?: number;
skillFilter?: string;
includeGit?: boolean;
}
// Handoff types
export interface HandoffDocument {
generatedAt: string;
fromAgent: string;
projectPath: string;
accomplished: HandoffSection;
pending: HandoffSection;
keyFiles: Array<{ path: string; changeType: string }>;
observations: {
errors: Array<{ action: string; error: string }>;
solutions: Array<{ action: string; solution: string }>;
patterns: Array<{ action: string; context: string }>;
};
recommendations: string[];
}
export interface HandoffSection {
tasks: Array<{ name: string; duration?: string; commitSha?: string }>;
commits: Array<{ sha: string; message: string; filesCount: number }>;
}
export interface HandoffOptions {
targetAgent?: string;
includeGit?: boolean;
includeObservations?: boolean;
maxObservations?: number;
}
// Lineage types
export interface SkillLineageEntry {
skillName: string;
executions: number;
totalDurationMs: number;
commits: string[];
filesModified: string[];
observationIds: string[];
firstSeen: string;
lastSeen: string;
}
export interface FileLineage {
path: string;
skills: string[];
commitCount: number;
lastModified: string;
}
export interface LineageData {
projectPath: string;
skills: SkillLineageEntry[];
files: FileLineage[];
stats: {
totalSkillExecutions: number;
totalCommits: number;
totalFilesChanged: number;
mostImpactfulSkill: string | null;
mostChangedFile: string | null;
errorProneFiles: string[];
};
}
export interface LineageOptions {
skill?: string;
file?: string;
limit?: number;
since?: string;
}
export interface SessionExplanation {
date: string;
agent: string;
+59
View File
@@ -0,0 +1,59 @@
/**
* POSIX-like shell word splitting that respects quoted substrings.
* Handles: simple words, "double quoted", 'single quoted', and
* --flag="value with spaces" correctly.
*/
export function splitCommand(command: string): string[] {
const tokens: string[] = [];
let current = "";
let inSingleQuote = false;
let inDoubleQuote = false;
for (let i = 0; i < command.length; i++) {
const ch = command[i];
if (inSingleQuote) {
if (ch === "'") {
inSingleQuote = false;
} else {
current += ch;
}
continue;
}
if (inDoubleQuote) {
if (ch === '"') {
inDoubleQuote = false;
} else {
current += ch;
}
continue;
}
if (ch === "'") {
inSingleQuote = true;
continue;
}
if (ch === '"') {
inDoubleQuote = true;
continue;
}
if (ch === " " || ch === "\t") {
if (current.length > 0) {
tokens.push(current);
current = "";
}
continue;
}
current += ch;
}
if (current.length > 0) {
tokens.push(current);
}
return tokens;
}
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/extension",
"version": "1.19.0",
"version": "1.19.2",
"private": true,
"description": "Chrome extension to save any webpage as an AI agent skill",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
import type { SaveResponse, ErrorResponse, ExtensionMessage } from './types';
const API_URL = 'https://agenstskills.com/api/save-skill';
const API_URL = 'https://skillkit.sh/api/save-skill';
chrome.runtime.onInstalled.addListener(() => {
chrome.contextMenus.create({
@@ -14,7 +14,7 @@ How it works:
- Right-click any page and select "Save page as Skill"
- Select text, right-click, and choose "Save selection as Skill"
When you save a page, the extension sends the page URL to agenstskills.com where it is converted to clean markdown with auto-generated tags and YAML frontmatter. The resulting skill file is downloaded to your computer. No page content, browsing history, or personal data is ever sent — only the URL of the page you choose to save.
When you save a page, the extension sends the page URL to our server (skillkit.sh / agenstskills.com) where it is converted to clean markdown with auto-generated tags and YAML frontmatter. The resulting skill file is downloaded to your computer. No page content, browsing history, or personal data is ever sent — only the URL of the page you choose to save.
Saving selected text works entirely offline with no network requests.
@@ -29,7 +29,7 @@ Features:
- Works on any webpage
- No account or API key required
Part of the SkillKit ecosystem: https://agenstskills.com
Part of the SkillKit ecosystem: https://skillkit.sh
## Category
Developer Tools
@@ -38,13 +38,13 @@ Developer Tools
English
## Website
https://agenstskills.com
https://skillkit.sh
## Support URL
https://github.com/rohitg00/skillkit/issues
## Privacy Policy URL
https://agenstskills.com/privacy.html
https://skillkit.sh/privacy.html
## Single Purpose
Save webpages as AI agent skill files (SKILL.md) for use with coding AI agents.
@@ -56,10 +56,10 @@ Save webpages as AI agent skill files (SKILL.md) for use with coding AI agents.
## Data Usage Disclosure (for Chrome Web Store Privacy tab)
- Does the extension use remote code? No
- Does it collect user data? No personal data. The page URL is sent to agenstskills.com when the user clicks save.
- Does it collect user data? No personal data. The page URL is sent to our server (skillkit.sh / agenstskills.com) when the user clicks save.
- Data type: Website content (URL only, on user action)
- Use: Required for core functionality (converting webpage to skill file)
- Transfer: Sent to agenstskills.com (our own server) over HTTPS
- Transfer: Sent to our server (skillkit.sh / agenstskills.com) over HTTPS
- Not sold to third parties
- Not used for creditworthiness or lending
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp-memory",
"version": "1.19.0",
"version": "1.19.2",
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp",
"version": "1.19.0",
"version": "1.19.2",
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/memory",
"version": "1.19.0",
"version": "1.19.2",
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mesh",
"version": "1.19.0",
"version": "1.19.2",
"description": "Peer mesh network for multi-machine agent distribution",
"type": "module",
"main": "./dist/index.js",
+40 -22
View File
@@ -1,7 +1,7 @@
import got from 'got';
import type { Host, HealthCheckResult, HostStatus } from '../types.js';
import { HEALTH_CHECK_TIMEOUT } from '../types.js';
import { getKnownHosts, updateKnownHost } from '../config/hosts-config.js';
import got from "got";
import type { Host, HealthCheckResult, HostStatus } from "../types.js";
import { HEALTH_CHECK_TIMEOUT } from "../types.js";
import { getKnownHosts, updateKnownHost } from "../config/hosts-config.js";
export interface HealthCheckOptions {
timeout?: number;
@@ -10,7 +10,7 @@ export interface HealthCheckOptions {
export async function checkHostHealth(
host: Host,
options: HealthCheckOptions = {}
options: HealthCheckOptions = {},
): Promise<HealthCheckResult> {
const timeout = options.timeout ?? HEALTH_CHECK_TIMEOUT;
const startTime = Date.now();
@@ -19,38 +19,42 @@ export async function checkHostHealth(
hostId: host.id,
address: host.address,
port: host.port,
status: 'unknown',
status: "unknown",
latencyMs: 0,
checkedAt: new Date().toISOString(),
};
try {
const url = `http://${host.address}:${host.port}/health`;
const protocol = host.tls ? "https" : "http";
const url = `${protocol}://${host.address}:${host.port}/health`;
const response = await got.get(url, {
timeout: { request: timeout },
retry: { limit: 0 },
throwHttpErrors: false,
...(host.tls && host.tlsAllowSelfSigned
? { https: { rejectUnauthorized: false } }
: {}),
});
result.latencyMs = Date.now() - startTime;
if (response.statusCode === 200) {
result.status = 'online';
result.status = "online";
} else {
result.status = 'offline';
result.status = "offline";
result.error = `HTTP ${response.statusCode}`;
}
} catch (err: any) {
result.latencyMs = Date.now() - startTime;
result.status = 'offline';
result.error = err.code || err.message || 'Connection failed';
result.status = "offline";
result.error = err.code || err.message || "Connection failed";
}
if (options.updateStatus !== false) {
await updateKnownHost(host.id, {
status: result.status,
lastSeen: result.status === 'online' ? result.checkedAt : host.lastSeen,
lastSeen: result.status === "online" ? result.checkedAt : host.lastSeen,
});
}
@@ -58,44 +62,46 @@ export async function checkHostHealth(
}
export async function checkAllHostsHealth(
options: HealthCheckOptions = {}
options: HealthCheckOptions = {},
): Promise<HealthCheckResult[]> {
const hosts = await getKnownHosts();
const results = await Promise.all(hosts.map(host => checkHostHealth(host, options)));
const results = await Promise.all(
hosts.map((host) => checkHostHealth(host, options)),
);
return results;
}
export async function getOnlineHosts(): Promise<Host[]> {
const hosts = await getKnownHosts();
return hosts.filter(h => h.status === 'online');
return hosts.filter((h) => h.status === "online");
}
export async function getOfflineHosts(): Promise<Host[]> {
const hosts = await getKnownHosts();
return hosts.filter(h => h.status === 'offline');
return hosts.filter((h) => h.status === "offline");
}
export async function waitForHost(
host: Host,
maxWaitMs = 30000,
intervalMs = 1000
intervalMs = 1000,
): Promise<boolean> {
const deadline = Date.now() + maxWaitMs;
while (Date.now() < deadline) {
const result = await checkHostHealth(host, { updateStatus: false });
if (result.status === 'online') {
if (result.status === "online") {
await updateKnownHost(host.id, {
status: 'online',
status: "online",
lastSeen: new Date().toISOString(),
});
return true;
}
await new Promise(resolve => setTimeout(resolve, intervalMs));
await new Promise((resolve) => setTimeout(resolve, intervalMs));
}
return false;
@@ -105,9 +111,21 @@ export class HealthMonitor {
private interval: NodeJS.Timeout | null = null;
private running = false;
private checking = false;
private onStatusChange?: (host: Host, oldStatus: HostStatus, newStatus: HostStatus) => void;
private onStatusChange?: (
host: Host,
oldStatus: HostStatus,
newStatus: HostStatus,
) => void;
constructor(options: { onStatusChange?: (host: Host, oldStatus: HostStatus, newStatus: HostStatus) => void } = {}) {
constructor(
options: {
onStatusChange?: (
host: Host,
oldStatus: HostStatus,
newStatus: HostStatus,
) => void;
} = {},
) {
this.onStatusChange = options.onStatusChange;
}
+52 -39
View File
@@ -1,11 +1,8 @@
import {
generateKeyPairSync,
createHash,
} from 'node:crypto';
import { readFile, writeFile, mkdir } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import { join } from 'node:path';
import { homedir } from 'node:os';
import { generateKeyPairSync, createHash } from "node:crypto";
import { readFile, writeFile, mkdir } from "node:fs/promises";
import { existsSync } from "node:fs";
import { join } from "node:path";
import { homedir } from "node:os";
export interface TLSContextOptions {
cert?: string;
@@ -31,26 +28,26 @@ export interface TLSConfig {
rejectUnauthorized?: boolean;
}
const DEFAULT_CERT_PATH = join(homedir(), '.skillkit', 'mesh', 'certs');
const DEFAULT_CERT_PATH = join(homedir(), ".skillkit", "mesh", "certs");
function generateSelfSignedCertificate(
hostId: string,
hostName: string,
validDays: number = 365
validDays: number = 365,
): { cert: string; key: string } {
const { publicKey, privateKey } = generateKeyPairSync('rsa', {
const { publicKey, privateKey } = generateKeyPairSync("rsa", {
modulusLength: 2048,
publicKeyEncoding: { type: 'spki', format: 'pem' },
privateKeyEncoding: { type: 'pkcs8', format: 'pem' },
publicKeyEncoding: { type: "spki", format: "pem" },
privateKeyEncoding: { type: "pkcs8", format: "pem" },
});
const notBefore = new Date();
const notAfter = new Date();
notAfter.setDate(notAfter.getDate() + validDays);
const serialNumber = createHash('sha256')
const serialNumber = createHash("sha256")
.update(hostId + Date.now().toString())
.digest('hex')
.digest("hex")
.slice(0, 16);
const certPem = createSimpleCert({
@@ -61,7 +58,7 @@ function generateSelfSignedCertificate(
serialNumber,
notBefore,
notAfter,
altNames: ['localhost', '127.0.0.1', hostName],
altNames: ["localhost", "127.0.0.1", hostName],
});
return {
@@ -83,15 +80,15 @@ interface CertParams {
function createSimpleCert(params: CertParams): string {
const base64Encode = (str: string): string =>
Buffer.from(str).toString('base64');
Buffer.from(str).toString("base64");
const formatDate = (date: Date): string => {
const y = date.getUTCFullYear().toString().slice(-2);
const m = (date.getUTCMonth() + 1).toString().padStart(2, '0');
const d = date.getUTCDate().toString().padStart(2, '0');
const h = date.getUTCHours().toString().padStart(2, '0');
const min = date.getUTCMinutes().toString().padStart(2, '0');
const s = date.getUTCSeconds().toString().padStart(2, '0');
const m = (date.getUTCMonth() + 1).toString().padStart(2, "0");
const d = date.getUTCDate().toString().padStart(2, "0");
const h = date.getUTCHours().toString().padStart(2, "0");
const min = date.getUTCMinutes().toString().padStart(2, "0");
const s = date.getUTCSeconds().toString().padStart(2, "0");
return `${y}${m}${d}${h}${min}${s}Z`;
};
@@ -109,13 +106,13 @@ function createSimpleCert(params: CertParams): string {
const certData = JSON.stringify(certInfo);
const certBase64 = base64Encode(certData);
const lines: string[] = ['-----BEGIN CERTIFICATE-----'];
const lines: string[] = ["-----BEGIN CERTIFICATE-----"];
for (let i = 0; i < certBase64.length; i += 64) {
lines.push(certBase64.slice(i, i + 64));
}
lines.push('-----END CERTIFICATE-----');
lines.push("-----END CERTIFICATE-----");
return lines.join('\n');
return lines.join("\n");
}
export class TLSManager {
@@ -133,15 +130,15 @@ export class TLSManager {
async generateCertificate(
hostId: string,
hostName: string = 'localhost',
validDays: number = 365
hostName: string = "localhost",
validDays: number = 365,
): Promise<CertificateInfo> {
await this.ensureDirectory();
const { cert, key } = generateSelfSignedCertificate(
hostId,
hostName,
validDays
validDays,
);
const certFile = join(this.certPath, `${hostId}.crt`);
@@ -150,7 +147,7 @@ export class TLSManager {
await writeFile(certFile, cert, { mode: 0o644 });
await writeFile(keyFile, key, { mode: 0o600 });
const fingerprint = createHash('sha256').update(cert).digest('hex');
const fingerprint = createHash("sha256").update(cert).digest("hex");
const notBefore = new Date();
const notAfter = new Date();
notAfter.setDate(notAfter.getDate() + validDays);
@@ -173,9 +170,9 @@ export class TLSManager {
return null;
}
const cert = await readFile(certFile, 'utf-8');
const key = await readFile(keyFile, 'utf-8');
const fingerprint = createHash('sha256').update(cert).digest('hex');
const cert = await readFile(certFile, "utf-8");
const key = await readFile(keyFile, "utf-8");
const fingerprint = createHash("sha256").update(cert).digest("hex");
return {
cert,
@@ -189,7 +186,7 @@ export class TLSManager {
async loadOrCreateCertificate(
hostId: string,
hostName: string = 'localhost'
hostName: string = "localhost",
): Promise<CertificateInfo> {
const existing = await this.loadCertificate(hostId);
if (existing) {
@@ -210,15 +207,25 @@ export class TLSManager {
};
}
/**
* @param options.allowSelfSigned - WARNING: disables certificate validation
* (rejectUnauthorized=false). Only safe for local development/testing.
* Defaults to true since the mesh system generates self-signed certs.
*/
createServerContext(
certInfo: CertificateInfo,
options?: { requestClientCert?: boolean; trustedCAs?: string[] }
options?: {
requestClientCert?: boolean;
trustedCAs?: string[];
allowSelfSigned?: boolean;
},
): TLSContextOptions {
const allowSelfSigned = options?.allowSelfSigned ?? true;
const context: TLSContextOptions = {
cert: certInfo.cert,
key: certInfo.key,
requestCert: options?.requestClientCert ?? false,
rejectUnauthorized: false,
rejectUnauthorized: !allowSelfSigned,
};
if (options?.trustedCAs?.length) {
@@ -231,10 +238,15 @@ export class TLSManager {
createClientContext(
certInfo?: CertificateInfo,
options?: { serverFingerprint?: string; trustedCAs?: string[] }
options?: {
serverFingerprint?: string;
trustedCAs?: string[];
allowSelfSigned?: boolean;
},
): TLSContextOptions {
const allowSelfSigned = options?.allowSelfSigned ?? true;
const context: TLSContextOptions = {
rejectUnauthorized: false,
rejectUnauthorized: !allowSelfSigned,
};
if (certInfo) {
@@ -244,18 +256,19 @@ export class TLSManager {
if (options?.trustedCAs?.length) {
context.ca = options.trustedCAs;
context.rejectUnauthorized = true;
}
return context;
}
static computeCertFingerprint(cert: string): string {
return createHash('sha256').update(cert).digest('hex');
return createHash("sha256").update(cert).digest("hex");
}
static verifyCertFingerprint(
cert: string,
expectedFingerprint: string
expectedFingerprint: string,
): boolean {
const actual = TLSManager.computeCertFingerprint(cert);
return actual.toLowerCase() === expectedFingerprint.toLowerCase();
+59 -34
View File
@@ -1,18 +1,18 @@
import got, { type Got } from 'got';
import { randomUUID } from 'node:crypto';
import got, { type Got } from "got";
import { randomUUID } from "node:crypto";
import type {
TransportMessage,
SecureTransportMessage,
Host,
} from '../types.js';
import { HEALTH_CHECK_TIMEOUT } from '../types.js';
import { PeerIdentity } from '../crypto/identity.js';
} from "../types.js";
import { HEALTH_CHECK_TIMEOUT } from "../types.js";
import { PeerIdentity } from "../crypto/identity.js";
import { AuthManager, createBearerHeader } from "../security/auth.js";
import {
AuthManager,
createBearerHeader,
} from '../security/auth.js';
import { type MeshSecurityConfig, DEFAULT_SECURITY_CONFIG } from '../security/config.js';
import { SecureKeystore } from '../crypto/keystore.js';
type MeshSecurityConfig,
DEFAULT_SECURITY_CONFIG,
} from "../security/config.js";
import { SecureKeystore } from "../crypto/keystore.js";
export interface SecureHttpTransportOptions {
timeout?: number;
@@ -48,8 +48,7 @@ export class SecureHttpTransport {
this.authToken = options.authToken ?? null;
this.security = options.security ?? DEFAULT_SECURITY_CONFIG;
const protocol =
this.security.transport.tls !== 'none' ? 'https' : 'http';
const protocol = this.security.transport.tls !== "none" ? "https" : "http";
const baseUrl = `${protocol}://${host.address}:${host.port}`;
this.client = got.extend({
@@ -60,11 +59,13 @@ export class SecureHttpTransport {
calculateDelay: () => this.options.retryDelay!,
},
https: {
rejectUnauthorized: false,
// MITM risk: disabling verification for self-signed mode.
// Ideally supply the CA cert via the `ca` option instead.
rejectUnauthorized: this.security.transport.tls !== "self-signed",
},
headers: {
'Content-Type': 'application/json',
'X-SkillKit-Transport': 'secure-http',
"Content-Type": "application/json",
"X-SkillKit-Transport": "secure-http",
...this.options.headers,
},
});
@@ -88,11 +89,11 @@ export class SecureHttpTransport {
const headers: Record<string, string> = {};
if (this.authToken) {
headers['Authorization'] = createBearerHeader(this.authToken);
headers["Authorization"] = createBearerHeader(this.authToken);
}
if (this.identity) {
headers['X-SkillKit-Fingerprint'] = this.identity.fingerprint;
headers["X-SkillKit-Fingerprint"] = this.identity.fingerprint;
}
return headers;
@@ -105,8 +106,8 @@ export class SecureHttpTransport {
const message: TransportMessage = {
id: randomUUID(),
type: 'request',
from: this.identity?.fingerprint ?? 'local',
type: "request",
from: this.identity?.fingerprint ?? "local",
to: path,
payload,
timestamp: new Date().toISOString(),
@@ -138,9 +139,9 @@ export class SecureHttpTransport {
async sendMessage(
to: string,
type: string,
payload: unknown
payload: unknown,
): Promise<TransportMessage> {
return this.send('message', {
return this.send("message", {
to,
type,
payload,
@@ -148,7 +149,7 @@ export class SecureHttpTransport {
}
async registerPeer(registration: unknown): Promise<TransportMessage> {
return this.send('peer/register', registration);
return this.send("peer/register", registration);
}
async getPeers(): Promise<TransportMessage> {
@@ -158,7 +159,7 @@ export class SecureHttpTransport {
const secureHeaders = await this.getSecureHeaders();
const response = await this.client.get('peers', {
const response = await this.client.get("peers", {
headers: secureHeaders,
});
@@ -167,7 +168,7 @@ export class SecureHttpTransport {
async healthCheck(): Promise<boolean> {
try {
const response = await this.client.get('health', {
const response = await this.client.get("health", {
headers: await this.getSecureHeaders(),
});
return response.statusCode === 200;
@@ -189,7 +190,7 @@ export async function sendToHostSecure(
host: Host,
path: string,
payload: unknown,
options: SecureHttpTransportOptions = {}
options: SecureHttpTransportOptions = {},
): Promise<TransportMessage> {
const transport = new SecureHttpTransport(host, options);
await transport.initialize();
@@ -200,7 +201,7 @@ export async function broadcastToHostsSecure(
hosts: Host[],
path: string,
payload: unknown,
options: SecureHttpTransportOptions = {}
options: SecureHttpTransportOptions = {},
): Promise<Map<string, TransportMessage | Error>> {
const results = new Map<string, TransportMessage | Error>();
@@ -212,25 +213,49 @@ export async function broadcastToHostsSecure(
} catch (err) {
results.set(host.id, err as Error);
}
})
}),
);
return results;
}
export function verifySecureMessage(
message: SecureTransportMessage
): { valid: boolean; error?: string } {
if (!message.signature || !message.senderPublicKey || !message.senderFingerprint) {
return { valid: false, error: 'Missing signature fields' };
export async function verifySecureMessage(
message: SecureTransportMessage,
): Promise<{
valid: boolean;
error?: string;
}> {
if (
!message.signature ||
!message.senderPublicKey ||
!message.senderFingerprint
) {
return { valid: false, error: "Missing signature fields" };
}
const computedFingerprint = PeerIdentity.computeFingerprint(
Buffer.from(message.senderPublicKey, 'hex')
Buffer.from(message.senderPublicKey, "hex"),
);
if (computedFingerprint !== message.senderFingerprint) {
return { valid: false, error: 'Fingerprint mismatch' };
return { valid: false, error: "Fingerprint mismatch" };
}
const {
signature,
senderFingerprint,
senderPublicKey,
nonce,
...baseMessage
} = message;
const messageJson = JSON.stringify(baseMessage);
const isValidSignature = await PeerIdentity.verifyHex(
signature,
Buffer.from(messageJson).toString("hex"),
senderPublicKey,
);
if (!isValidSignature) {
return { valid: false, error: "Invalid signature" };
}
return { valid: true };
+150 -100
View File
@@ -1,19 +1,29 @@
import WebSocket, { WebSocketServer } from 'ws';
import { createServer as createHttpsServer, type Server as HttpsServer } from 'node:https';
import { randomUUID } from 'node:crypto';
import WebSocket, { WebSocketServer } from "ws";
import {
createServer as createHttpsServer,
type Server as HttpsServer,
} from "node:https";
import { randomUUID } from "node:crypto";
import type {
TransportMessage,
SecureTransportMessage,
Host,
} from '../types.js';
import { DEFAULT_PORT } from '../types.js';
import { PeerIdentity } from '../crypto/identity.js';
import { MessageEncryption } from '../crypto/encryption.js';
import { AuthManager, type AuthChallengeRequest, type AuthChallengeResponse } from '../security/auth.js';
import { TLSManager, type CertificateInfo } from '../security/tls.js';
import { type MeshSecurityConfig, DEFAULT_SECURITY_CONFIG } from '../security/config.js';
import { SecureKeystore } from '../crypto/keystore.js';
import { hexToBytes } from '@noble/hashes/utils';
} from "../types.js";
import { DEFAULT_PORT } from "../types.js";
import { PeerIdentity } from "../crypto/identity.js";
import { MessageEncryption } from "../crypto/encryption.js";
import {
AuthManager,
type AuthChallengeRequest,
type AuthChallengeResponse,
} from "../security/auth.js";
import { TLSManager, type CertificateInfo } from "../security/tls.js";
import {
type MeshSecurityConfig,
DEFAULT_SECURITY_CONFIG,
} from "../security/config.js";
import { SecureKeystore } from "../crypto/keystore.js";
import { hexToBytes } from "@noble/hashes/utils";
export interface SecureWebSocketOptions {
timeout?: number;
@@ -28,7 +38,7 @@ export interface SecureWebSocketOptions {
export type SecureMessageHandler = (
message: TransportMessage,
socket: WebSocket,
senderFingerprint?: string
senderFingerprint?: string,
) => void;
interface AuthenticatedClient {
@@ -41,7 +51,9 @@ interface AuthenticatedClient {
export class SecureWebSocketTransport {
private socket: WebSocket | null = null;
private host: Host;
private options: Required<Omit<SecureWebSocketOptions, 'identity' | 'keystore'>>;
private options: Required<
Omit<SecureWebSocketOptions, "identity" | "keystore">
>;
private identity: PeerIdentity | null = null;
private keystore: SecureKeystore | null = null;
private authManager: AuthManager | null = null;
@@ -77,7 +89,7 @@ export class SecureWebSocketTransport {
private getUrl(): string {
const protocol =
this.options.security.transport.tls !== 'none' ? 'wss' : 'ws';
this.options.security.transport.tls !== "none" ? "wss" : "ws";
return `${protocol}://${this.host.address}:${this.host.port}/ws`;
}
@@ -90,17 +102,18 @@ export class SecureWebSocketTransport {
const url = this.getUrl();
const wsOptions: WebSocket.ClientOptions = {
handshakeTimeout: this.options.timeout,
rejectUnauthorized: false,
rejectUnauthorized:
this.options.security.transport.tls === "self-signed" ? false : true,
};
this.socket = new WebSocket(url, wsOptions);
const timeout = setTimeout(() => {
this.socket?.close();
reject(new Error('Connection timeout'));
reject(new Error("Connection timeout"));
}, this.options.timeout);
this.socket.on('open', async () => {
this.socket.on("open", async () => {
clearTimeout(timeout);
this.connected = true;
this.reconnectAttempts = 0;
@@ -121,11 +134,11 @@ export class SecureWebSocketTransport {
resolve();
});
this.socket.on('message', async (data) => {
this.socket.on("message", async (data) => {
try {
const raw = JSON.parse(data.toString());
if (raw.type === 'auth:challenge') {
if (raw.type === "auth:challenge") {
return;
}
@@ -133,10 +146,12 @@ export class SecureWebSocketTransport {
let senderFingerprint: string | undefined;
if (this.encryption && raw.ciphertext) {
const decrypted = this.encryption.decryptToObject<TransportMessage>({
nonce: raw.nonce,
ciphertext: raw.ciphertext,
});
const decrypted = this.encryption.decryptToObject<TransportMessage>(
{
nonce: raw.nonce,
ciphertext: raw.ciphertext,
},
);
message = decrypted;
senderFingerprint = raw.senderFingerprint;
} else if (raw.signature) {
@@ -155,13 +170,14 @@ export class SecureWebSocketTransport {
}
this.messageHandlers.forEach((handler) =>
handler(message, this.socket!, senderFingerprint)
handler(message, this.socket!, senderFingerprint),
);
} catch {
} catch (err) {
console.error("[SecureWebSocket] client message handler error:", err);
}
});
this.socket.on('close', () => {
this.socket.on("close", () => {
this.connected = false;
this.authenticated = false;
if (this.options.reconnect) {
@@ -169,7 +185,7 @@ export class SecureWebSocketTransport {
}
});
this.socket.on('error', (err) => {
this.socket.on("error", (err) => {
clearTimeout(timeout);
if (!this.connected) {
reject(err);
@@ -183,43 +199,49 @@ export class SecureWebSocketTransport {
const handleChallenge = async (data: WebSocket.Data) => {
try {
const msg = JSON.parse(data.toString());
if (msg.type === 'auth:challenge') {
if (msg.type === "auth:challenge") {
const challenge: AuthChallengeRequest = {
challenge: msg.challenge,
timestamp: msg.timestamp,
};
const response = await this.authManager!.respondToChallenge(challenge);
const response =
await this.authManager!.respondToChallenge(challenge);
this.socket!.send(
JSON.stringify({
type: 'auth:response',
type: "auth:response",
...response,
})
}),
);
} else if (msg.type === 'auth:success') {
this.socket!.off('message', handleChallenge);
} else if (msg.type === "auth:success") {
this.socket!.off("message", handleChallenge);
clearTimeout(authTimeout);
if (msg.serverPublicKey) {
const serverPubKey = hexToBytes(msg.serverPublicKey);
const sharedSecret = this.identity!.deriveSharedSecret(serverPubKey);
const sharedSecret =
this.identity!.deriveSharedSecret(serverPubKey);
this.encryption = new MessageEncryption(sharedSecret);
}
resolve();
} else if (msg.type === 'auth:failed') {
this.socket!.off('message', handleChallenge);
reject(new Error(msg.error || 'Authentication failed'));
} else if (msg.type === "auth:failed") {
this.socket!.off("message", handleChallenge);
clearTimeout(authTimeout);
reject(new Error(msg.error || "Authentication failed"));
}
} catch (err) {
this.socket!.off("message", handleChallenge);
clearTimeout(authTimeout);
reject(err);
}
};
this.socket!.on('message', handleChallenge);
this.socket!.on("message", handleChallenge);
setTimeout(() => {
this.socket!.off('message', handleChallenge);
reject(new Error('Authentication timeout'));
const authTimeout = setTimeout(() => {
this.socket!.off("message", handleChallenge);
reject(new Error("Authentication timeout"));
}, this.options.timeout);
});
}
@@ -241,14 +263,14 @@ export class SecureWebSocketTransport {
}
async send(
message: Omit<TransportMessage, 'id' | 'timestamp'>
message: Omit<TransportMessage, "id" | "timestamp">,
): Promise<void> {
if (!this.socket || !this.connected) {
throw new Error('Not connected');
throw new Error("Not connected");
}
if (!this.authenticated) {
throw new Error('Not authenticated');
throw new Error("Not authenticated");
}
const fullMessage: TransportMessage = {
@@ -261,7 +283,7 @@ export class SecureWebSocketTransport {
if (
this.encryption &&
this.options.security.transport.encryption === 'required'
this.options.security.transport.encryption === "required"
) {
const encrypted = this.encryption.encryptObject(fullMessage);
dataToSend = JSON.stringify({
@@ -348,7 +370,7 @@ export class SecureWebSocketServer {
identity?: PeerIdentity;
keystore?: SecureKeystore;
hostId?: string;
} = {}
} = {},
) {
this.port = port;
this.security = options.security ?? DEFAULT_SECURITY_CONFIG;
@@ -366,11 +388,11 @@ export class SecureWebSocketServer {
}
this.authManager = new AuthManager(this.identity);
if (this.security.transport.tls !== 'none') {
if (this.security.transport.tls !== "none") {
this.tlsManager = new TLSManager();
this.certInfo = await this.tlsManager.loadOrCreateCertificate(
this.hostId,
'localhost'
"localhost",
);
}
}
@@ -381,7 +403,15 @@ export class SecureWebSocketServer {
await this.initialize();
return new Promise((resolve, reject) => {
if (this.security.transport.tls !== 'none' && this.certInfo) {
if (this.security.transport.tls !== "none") {
if (!this.certInfo) {
reject(
new Error(
"TLS is configured but certificate is not available; refusing to start in plaintext",
),
);
return;
}
this.httpsServer = createHttpsServer({
cert: this.certInfo.cert,
key: this.certInfo.key,
@@ -389,7 +419,7 @@ export class SecureWebSocketServer {
this.wss = new WebSocketServer({
server: this.httpsServer,
path: '/ws',
path: "/ws",
});
this.httpsServer.listen(this.port, () => {
@@ -397,19 +427,19 @@ export class SecureWebSocketServer {
resolve();
});
this.httpsServer.on('error', reject);
this.httpsServer.on("error", reject);
} else {
this.wss = new WebSocketServer({ port: this.port, path: '/ws' });
this.wss = new WebSocketServer({ port: this.port, path: "/ws" });
this.wss.on('listening', () => {
this.wss.on("listening", () => {
this.running = true;
resolve();
});
this.wss.on('error', reject);
this.wss.on("error", reject);
}
this.wss.on('connection', (socket) => {
this.wss.on("connection", (socket) => {
this.handleConnection(socket);
});
});
@@ -427,16 +457,16 @@ export class SecureWebSocketServer {
} else {
this.clients.set(socket, {
socket,
fingerprint: 'anonymous',
publicKey: '',
fingerprint: "anonymous",
publicKey: "",
});
}
socket.on('message', async (data) => {
socket.on("message", async (data) => {
try {
const raw = JSON.parse(data.toString());
if (raw.type === 'auth:response') {
if (raw.type === "auth:response") {
return;
}
@@ -447,10 +477,12 @@ export class SecureWebSocketServer {
let senderFingerprint: string | undefined = client.fingerprint;
if (client.encryption && raw.ciphertext) {
const decrypted = client.encryption.decryptToObject<TransportMessage>({
nonce: raw.nonce,
ciphertext: raw.ciphertext,
});
const decrypted = client.encryption.decryptToObject<TransportMessage>(
{
nonce: raw.nonce,
ciphertext: raw.ciphertext,
},
);
message = decrypted;
} else if (raw.signature) {
const secure = raw as SecureTransportMessage;
@@ -468,41 +500,46 @@ export class SecureWebSocketServer {
}
this.messageHandlers.forEach((handler) =>
handler(message, socket, senderFingerprint)
handler(message, socket, senderFingerprint),
);
} catch {
} catch (err) {
console.error("[SecureWebSocket] server message handler error:", err);
}
});
socket.on('close', () => {
socket.on("error", (err) => {
console.error("[SecureWebSocket] socket error:", err);
});
socket.on("close", () => {
this.clients.delete(socket);
});
}
private async performServerHandshake(
socket: WebSocket
socket: WebSocket,
): Promise<AuthenticatedClient> {
return new Promise((resolve, reject) => {
const challenge = this.authManager!.createChallenge();
socket.send(
JSON.stringify({
type: 'auth:challenge',
type: "auth:challenge",
...challenge,
})
}),
);
const timeout = setTimeout(() => {
socket.off('message', handleResponse);
reject(new Error('Handshake timeout'));
socket.off("message", handleResponse);
reject(new Error("Handshake timeout"));
}, 10000);
const handleResponse = async (data: WebSocket.Data) => {
try {
const msg = JSON.parse(data.toString());
if (msg.type === 'auth:response') {
if (msg.type === "auth:response") {
clearTimeout(timeout);
socket.off('message', handleResponse);
socket.off("message", handleResponse);
const response: AuthChallengeResponse = {
challenge: msg.challenge,
@@ -518,41 +555,44 @@ export class SecureWebSocketServer {
if (!result.authenticated) {
socket.send(
JSON.stringify({
type: 'auth:failed',
type: "auth:failed",
error: result.error,
})
}),
);
reject(new Error(result.error));
return;
}
if (this.keystore) {
const isRevoked = await this.keystore.isRevoked(result.fingerprint!);
const isRevoked = await this.keystore.isRevoked(
result.fingerprint!,
);
if (isRevoked) {
socket.send(
JSON.stringify({
type: 'auth:failed',
error: 'Peer is revoked',
})
type: "auth:failed",
error: "Peer is revoked",
}),
);
reject(new Error('Peer is revoked'));
reject(new Error("Peer is revoked"));
return;
}
}
let encryption: MessageEncryption | undefined;
if (this.security.transport.encryption === 'required') {
if (this.security.transport.encryption === "required") {
const clientPubKey = hexToBytes(response.publicKey);
const sharedSecret = this.identity!.deriveSharedSecret(clientPubKey);
const sharedSecret =
this.identity!.deriveSharedSecret(clientPubKey);
encryption = new MessageEncryption(sharedSecret);
}
socket.send(
JSON.stringify({
type: 'auth:success',
type: "auth:success",
serverFingerprint: this.identity!.fingerprint,
serverPublicKey: this.identity!.publicKeyHex,
})
}),
);
resolve({
@@ -568,7 +608,7 @@ export class SecureWebSocketServer {
}
};
socket.on('message', handleResponse);
socket.on("message", handleResponse);
});
}
@@ -588,7 +628,7 @@ export class SecureWebSocketServer {
}
async broadcast(
message: Omit<TransportMessage, 'id' | 'timestamp'>
message: Omit<TransportMessage, "id" | "timestamp">,
): Promise<void> {
const fullMessage: TransportMessage = {
...message,
@@ -596,6 +636,19 @@ export class SecureWebSocketServer {
timestamp: new Date().toISOString(),
};
let sharedSignedData: string | null = null;
if (this.identity) {
const signature = await this.identity.signObject(fullMessage);
const secureMessage: SecureTransportMessage = {
...fullMessage,
signature,
senderFingerprint: this.identity.fingerprint,
senderPublicKey: this.identity.publicKeyHex,
nonce: randomUUID(),
};
sharedSignedData = JSON.stringify(secureMessage);
}
for (const [socket, client] of this.clients) {
if (socket.readyState !== WebSocket.OPEN) continue;
@@ -610,27 +663,22 @@ export class SecureWebSocketServer {
ciphertext: encrypted.ciphertext,
timestamp: fullMessage.timestamp,
});
} else if (this.identity) {
const signature = await this.identity.signObject(fullMessage);
const secureMessage: SecureTransportMessage = {
...fullMessage,
signature,
senderFingerprint: this.identity.fingerprint,
senderPublicKey: this.identity.publicKeyHex,
nonce: randomUUID(),
};
dataToSend = JSON.stringify(secureMessage);
} else if (sharedSignedData) {
dataToSend = sharedSignedData;
} else {
dataToSend = JSON.stringify(fullMessage);
}
socket.send(dataToSend);
socket.send(dataToSend, (err) => {
if (err)
console.error("[SecureWebSocketServer] broadcast send error:", err);
});
}
}
async sendTo(
socket: WebSocket,
message: Omit<TransportMessage, 'id' | 'timestamp'>
message: Omit<TransportMessage, "id" | "timestamp">,
): Promise<void> {
if (socket.readyState !== WebSocket.OPEN) return;
@@ -668,7 +716,9 @@ export class SecureWebSocketServer {
dataToSend = JSON.stringify(fullMessage);
}
socket.send(dataToSend);
socket.send(dataToSend, (err) => {
if (err) console.error("[SecureWebSocketServer] sendTo error:", err);
});
}
onMessage(handler: SecureMessageHandler): () => void {
+5 -3
View File
@@ -1,4 +1,4 @@
export type HostStatus = 'online' | 'offline' | 'unknown';
export type HostStatus = "online" | "offline" | "unknown";
export interface Host {
id: string;
@@ -10,6 +10,8 @@ export interface Host {
lastSeen: string;
version?: string;
metadata?: Record<string, unknown>;
tls?: boolean;
tlsAllowSelfSigned?: boolean;
}
export interface Peer {
@@ -46,7 +48,7 @@ export interface HostsFile {
}
export interface DiscoveryMessage {
type: 'announce' | 'query' | 'response';
type: "announce" | "query" | "response";
hostId: string;
hostName: string;
address: string;
@@ -121,4 +123,4 @@ export const DEFAULT_PORT = 9876;
export const DEFAULT_DISCOVERY_PORT = 9877;
export const HEALTH_CHECK_TIMEOUT = 5000;
export const DISCOVERY_INTERVAL = 30000;
export const MESH_VERSION = '1.7.11';
export const MESH_VERSION = "1.7.11";
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/messaging",
"version": "1.19.0",
"version": "1.19.2",
"description": "Inter-agent messaging system for SkillKit",
"type": "module",
"main": "./dist/index.js",
+42 -16
View File
@@ -1,9 +1,11 @@
import got from 'got';
import type { Message, MessageDeliveryResult } from '../types.js';
import got from "got";
import type { Message, MessageDeliveryResult } from "../types.js";
export interface RemoteTransportOptions {
timeout?: number;
retries?: number;
useHttps?: boolean;
rejectUnauthorized?: boolean;
}
export class RemoteTransport {
@@ -13,15 +15,31 @@ export class RemoteTransport {
this.options = {
timeout: options.timeout ?? 10000,
retries: options.retries ?? 2,
useHttps: options.useHttps ?? false,
rejectUnauthorized: options.rejectUnauthorized ?? true,
};
}
private getProtocol(hostAddress: string): string {
const isLocalhost =
hostAddress === "localhost" ||
hostAddress === "127.0.0.1" ||
hostAddress === "::1";
return this.options.useHttps && !isLocalhost ? "https" : "http";
}
private formatHost(hostAddress: string): string {
return hostAddress.includes(":") && !hostAddress.startsWith("[")
? `[${hostAddress}]`
: hostAddress;
}
async deliver(
message: Message,
hostAddress: string,
hostPort: number
hostPort: number,
): Promise<MessageDeliveryResult> {
const url = `http://${hostAddress}:${hostPort}/message`;
const url = `${this.getProtocol(hostAddress)}://${this.formatHost(hostAddress)}:${hostPort}/message`;
try {
const response = await got.post(url, {
@@ -29,6 +47,9 @@ export class RemoteTransport {
timeout: { request: this.options.timeout },
retry: { limit: this.options.retries },
throwHttpErrors: false,
...(this.options.useHttps && {
https: { rejectUnauthorized: this.options.rejectUnauthorized },
}),
});
if (response.statusCode === 200 || response.statusCode === 201) {
@@ -36,7 +57,7 @@ export class RemoteTransport {
messageId: message.id,
delivered: true,
deliveredAt: new Date().toISOString(),
via: 'remote',
via: "remote",
};
}
@@ -44,34 +65,36 @@ export class RemoteTransport {
messageId: message.id,
delivered: false,
error: `HTTP ${response.statusCode}: ${response.body}`,
via: 'remote',
via: "remote",
};
} catch (err: any) {
return {
messageId: message.id,
delivered: false,
error: err.message || 'Connection failed',
via: 'remote',
error: err.message || "Connection failed",
via: "remote",
};
}
}
async deliverToAgent(
message: Message,
agentAddress: string
agentAddress: string,
): Promise<MessageDeliveryResult> {
const parts = agentAddress.split('@');
const parts = agentAddress.split("@");
if (parts.length !== 2) {
return {
messageId: message.id,
delivered: false,
error: 'Invalid agent address format. Expected: agentId@host:port',
via: 'remote',
error: "Invalid agent address format. Expected: agentId@host:port",
via: "remote",
};
}
const [, hostPart] = parts;
const [host, portStr] = hostPart.split(':');
const lastColon = hostPart.lastIndexOf(":");
const host = lastColon > 0 ? hostPart.slice(0, lastColon) : hostPart;
const portStr = lastColon > 0 ? hostPart.slice(lastColon + 1) : undefined;
const port = portStr ? parseInt(portStr, 10) : 9876;
return this.deliver(message, host, port);
@@ -79,7 +102,7 @@ export class RemoteTransport {
async broadcast(
message: Message,
hosts: Array<{ address: string; port: number }>
hosts: Array<{ address: string; port: number }>,
): Promise<Map<string, MessageDeliveryResult>> {
const results = new Map<string, MessageDeliveryResult>();
@@ -87,20 +110,23 @@ export class RemoteTransport {
hosts.map(async ({ address, port }) => {
const result = await this.deliver(message, address, port);
results.set(`${address}:${port}`, result);
})
}),
);
return results;
}
async ping(hostAddress: string, hostPort: number): Promise<boolean> {
const url = `http://${hostAddress}:${hostPort}/health`;
const url = `${this.getProtocol(hostAddress)}://${this.formatHost(hostAddress)}:${hostPort}/health`;
try {
const response = await got.get(url, {
timeout: { request: 5000 },
retry: { limit: 0 },
throwHttpErrors: false,
...(this.options.useHttps && {
https: { rejectUnauthorized: this.options.rejectUnauthorized },
}),
});
return response.statusCode === 200;
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/resources",
"version": "1.19.0",
"version": "1.19.2",
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/tui",
"version": "1.19.0",
"version": "1.19.2",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
+5 -1
View File
@@ -9,9 +9,10 @@ import {
Home, Browse, Installed, Marketplace, Settings, Recommend,
Translate, Context, Memory, Team, Plugins, Methodology,
Plan, Workflow, Execute, History, Sync, Help, Mesh, Message, Scan,
Timeline, Lineage, Handoff,
} from './screens/index.js';
const DOCS_URL = 'https://agenstskills.com/docs';
const DOCS_URL = 'https://skillkit.sh/docs';
function openUrl(url: string): void {
if (process.platform === 'win32') {
@@ -138,6 +139,9 @@ export function App(props: AppProps) {
<Match when={currentScreen() === 'mesh'}><Mesh {...screenProps()} /></Match>
<Match when={currentScreen() === 'message'}><Message {...screenProps()} /></Match>
<Match when={currentScreen() === 'scan'}><Scan {...screenProps()} /></Match>
<Match when={currentScreen() === 'timeline'}><Timeline {...screenProps()} /></Match>
<Match when={currentScreen() === 'lineage'}><Lineage {...screenProps()} /></Match>
<Match when={currentScreen() === 'handoff'}><Handoff {...screenProps()} /></Match>
</Switch>
</box>
</box>
@@ -29,6 +29,9 @@ const SCREEN_LABELS: Record<Screen, string> = {
mesh: 'Mesh',
message: 'Message',
scan: 'Security Scan',
timeline: 'Timeline',
lineage: 'Lineage',
handoff: 'Handoff',
};
export function BottomStatusBar(props: BottomStatusBarProps) {
+231
View File
@@ -0,0 +1,231 @@
import { createSignal, createEffect, Show, For } from 'solid-js';
import { useKeyboard } from '@opentui/solid';
import { type Screen } from '../state/index.js';
import { terminalColors } from '../theme/colors.js';
import { Header } from '../components/Header.js';
import { Spinner } from '../components/Spinner.js';
import { EmptyState } from '../components/EmptyState.js';
import { execFile } from 'node:child_process';
function changeTypeLabel(changeType: string): string {
switch (changeType) {
case 'modified': return 'M';
case 'created': return 'A';
default: return 'D';
}
}
interface HandoffProps {
onNavigate: (screen: Screen) => void;
cols?: number;
rows?: number;
}
interface HandoffTask {
name: string;
duration?: string;
commitSha?: string;
}
interface HandoffCommit {
sha: string;
message: string;
filesCount: number;
}
interface HandoffResult {
generatedAt: string;
fromAgent: string;
projectPath: string;
accomplished: { tasks: HandoffTask[]; commits: HandoffCommit[] };
pending: { tasks: HandoffTask[]; commits: HandoffCommit[] };
keyFiles: Array<{ path: string; changeType: string }>;
observations: {
errors: Array<{ action: string; error: string }>;
solutions: Array<{ action: string; solution: string }>;
patterns: Array<{ action: string; context: string }>;
};
recommendations: string[];
}
type SectionView = 'accomplished' | 'pending' | 'files' | 'recommendations';
export function Handoff(props: HandoffProps) {
const [loading, setLoading] = createSignal(true);
const [result, setResult] = createSignal<HandoffResult | null>(null);
const [error, setError] = createSignal<string | null>(null);
const [section, setSection] = createSignal<SectionView>('accomplished');
const loadHandoff = () => {
setLoading(true);
setError(null);
try {
execFile('npx', ['skillkit', 'session', 'handoff', '--json'], {
timeout: 15000,
maxBuffer: 1024 * 1024,
}, (err, stdout, stderr) => {
setLoading(false);
if (err && !stdout) {
setError(stderr || err.message || 'Failed to generate handoff');
return;
}
try {
const parsed = JSON.parse(stdout) as HandoffResult;
setResult(parsed);
} catch {
setError('Failed to parse handoff data');
}
});
} catch (err) {
setLoading(false);
setError(err instanceof Error ? err.message : 'Failed to generate handoff');
}
};
createEffect(() => {
loadHandoff();
});
const sections: SectionView[] = ['accomplished', 'pending', 'files', 'recommendations'];
useKeyboard((key: { name?: string }) => {
if (key.name === 'tab') {
const idx = sections.indexOf(section());
setSection(sections[(idx + 1) % sections.length]);
} else if (key.name === 'r') {
loadHandoff();
} else if (key.name === 'escape') {
props.onNavigate('home');
}
});
return (
<box flexDirection="column" padding={1}>
<Header
title="Handoff"
subtitle="agent-to-agent context transfer"
icon="⇄"
/>
<Show when={loading()}>
<Spinner label="Generating handoff document..." />
</Show>
<Show when={error()}>
<box flexDirection="column">
<text fg="#ff5555">Error: {error()}</text>
<text fg={terminalColors.textMuted}>Press r to retry</text>
</box>
</Show>
<Show when={!loading() && !error() && result()}>
<box flexDirection="row" gap={1} marginBottom={1}>
<text fg={terminalColors.textMuted}>from:</text>
<text fg={terminalColors.text}>{result()!.fromAgent}</text>
<text fg={terminalColors.textMuted}>|</text>
<text fg={terminalColors.textMuted}>{result()!.generatedAt}</text>
</box>
<box flexDirection="row" gap={2} marginBottom={1}>
<For each={sections}>
{(s) => (
<text
fg={section() === s ? terminalColors.accent : terminalColors.textMuted}
bold={section() === s}
>
{s.charAt(0).toUpperCase() + s.slice(1)}
</text>
)}
</For>
<text fg={terminalColors.textMuted}>(Tab to switch)</text>
</box>
<text fg={terminalColors.textMuted}>{'─'.repeat(Math.min(60, (props.cols ?? 80) - 4))}</text>
<Show when={section() === 'accomplished'}>
<text fg={terminalColors.text} bold>Accomplished Tasks</text>
<text> </text>
<Show when={result()!.accomplished.tasks.length === 0}>
<EmptyState title="No accomplished tasks in this session" />
</Show>
<For each={result()!.accomplished.tasks}>
{(task) => (
<box flexDirection="row" gap={1}>
<text fg="#22cc44">✓</text>
<text fg={terminalColors.text}>{task.name}</text>
<Show when={task.duration}>
<text fg={terminalColors.textMuted}>({task.duration})</text>
</Show>
</box>
)}
</For>
<Show when={result()!.accomplished.commits.length > 0}>
<text> </text>
<text fg={terminalColors.text} bold>Commits</text>
<For each={result()!.accomplished.commits}>
{(commit) => (
<box flexDirection="row" gap={1}>
<text fg="#fbbf24">●</text>
<text fg={terminalColors.textMuted}>{commit.sha.slice(0, 7)}</text>
<text fg={terminalColors.text}>{commit.message}</text>
</box>
)}
</For>
</Show>
</Show>
<Show when={section() === 'pending'}>
<text fg={terminalColors.text} bold>Pending Tasks</text>
<text> </text>
<Show when={result()!.pending.tasks.length === 0}>
<EmptyState title="No pending tasks" />
</Show>
<For each={result()!.pending.tasks}>
{(task) => (
<box flexDirection="row" gap={1}>
<text fg="#ffaa00">○</text>
<text fg={terminalColors.text}>{task.name}</text>
</box>
)}
</For>
</Show>
<Show when={section() === 'files'}>
<text fg={terminalColors.text} bold>Key Files</text>
<text> </text>
<Show when={result()!.keyFiles.length === 0}>
<EmptyState title="No key files tracked" />
</Show>
<For each={result()!.keyFiles}>
{(file) => (
<box flexDirection="row" gap={1}>
<text fg={terminalColors.textMuted}>{changeTypeLabel(file.changeType)}</text>
<text fg={terminalColors.text}>{file.path}</text>
</box>
)}
</For>
</Show>
<Show when={section() === 'recommendations'}>
<text fg={terminalColors.text} bold>Recommendations</text>
<text> </text>
<Show when={result()!.recommendations.length === 0}>
<EmptyState title="No recommendations" />
</Show>
<For each={result()!.recommendations}>
{(rec) => (
<box flexDirection="row" gap={1}>
<text fg={terminalColors.accent}>→</text>
<text fg={terminalColors.text}>{rec}</text>
</box>
)}
</For>
</Show>
</Show>
<text> </text>
<text fg={terminalColors.textMuted}>Tab switch section r refresh esc back</text>
</box>
);
}
+246
View File
@@ -0,0 +1,246 @@
import { createSignal, createEffect, Show, For, createMemo } from 'solid-js';
import { useKeyboard } from '@opentui/solid';
import { type Screen } from '../state/index.js';
import { terminalColors } from '../theme/colors.js';
import { Header } from '../components/Header.js';
import { Spinner } from '../components/Spinner.js';
import { EmptyState } from '../components/EmptyState.js';
import { execFile } from 'node:child_process';
interface LineageProps {
onNavigate: (screen: Screen) => void;
cols?: number;
rows?: number;
}
interface SkillLineageEntry {
skillName: string;
executions: number;
totalDurationMs: number;
commits: string[];
filesModified: string[];
firstSeen: string;
lastSeen: string;
}
interface FileLineage {
path: string;
skills: string[];
commitCount: number;
lastModified: string;
}
interface LineageResult {
projectPath: string;
skills: SkillLineageEntry[];
files: FileLineage[];
stats: {
totalSkillExecutions: number;
totalCommits: number;
totalFilesChanged: number;
mostImpactfulSkill: string | null;
mostChangedFile: string | null;
errorProneFiles: string[];
};
}
type ViewMode = 'skills' | 'files';
function formatDuration(ms: number): string {
const seconds = Math.floor(ms / 1000);
const minutes = Math.floor(seconds / 60);
if (minutes > 0) return `${minutes}m`;
return `${seconds}s`;
}
export function Lineage(props: LineageProps) {
const [loading, setLoading] = createSignal(true);
const [result, setResult] = createSignal<LineageResult | null>(null);
const [error, setError] = createSignal<string | null>(null);
const [selectedIndex, setSelectedIndex] = createSignal(0);
const [viewMode, setViewMode] = createSignal<ViewMode>('skills');
const rows = () => props.rows ?? 24;
const visibleCount = () => Math.max(1, rows() - 14);
const loadLineage = () => {
setLoading(true);
setError(null);
try {
execFile('npx', ['skillkit', 'lineage', '--json'], {
timeout: 15000,
maxBuffer: 1024 * 1024,
}, (err, stdout, stderr) => {
setLoading(false);
if (err && !stdout) {
setError(stderr || err.message || 'Failed to load lineage');
return;
}
try {
const parsed = JSON.parse(stdout) as LineageResult;
setResult(parsed);
} catch {
setError('Failed to parse lineage data');
}
});
} catch (err) {
setLoading(false);
setError(err instanceof Error ? err.message : 'Failed to load lineage');
}
};
createEffect(() => {
loadLineage();
});
const items = createMemo(() => {
if (viewMode() === 'skills') return result()?.skills ?? [];
return result()?.files ?? [];
});
const windowStart = createMemo(() => Math.max(0, selectedIndex() - visibleCount() + 1));
const visibleItems = createMemo(() =>
items().slice(windowStart(), windowStart() + visibleCount())
);
useKeyboard((key: { name?: string }) => {
if (key.name === 'k' || key.name === 'up') {
setSelectedIndex(i => Math.max(0, i - 1));
} else if (key.name === 'j' || key.name === 'down') {
setSelectedIndex(i => items().length > 0 ? Math.min(items().length - 1, i + 1) : 0);
} else if (key.name === 'tab') {
setViewMode(m => m === 'skills' ? 'files' : 'skills');
setSelectedIndex(0);
} else if (key.name === 'r') {
loadLineage();
} else if (key.name === 'escape') {
props.onNavigate('home');
}
});
return (
<box flexDirection="column" padding={1}>
<Header
title="Lineage"
subtitle="skill impact graph"
icon="◉"
/>
<Show when={loading()}>
<Spinner label="Loading lineage..." />
</Show>
<Show when={error()}>
<box flexDirection="column">
<text fg="#ff5555">Error: {error()}</text>
<text fg={terminalColors.textMuted}>Press r to retry</text>
</box>
</Show>
<Show when={!loading() && !error() && result()}>
<box flexDirection="row" gap={2} marginBottom={1}>
<text fg={terminalColors.text}>{result()!.stats.totalSkillExecutions} executions</text>
<text fg={terminalColors.textMuted}>|</text>
<text fg={terminalColors.text}>{result()!.stats.totalCommits} commits</text>
<text fg={terminalColors.textMuted}>|</text>
<text fg={terminalColors.text}>{result()!.stats.totalFilesChanged} files</text>
<Show when={result()!.stats.mostImpactfulSkill}>
<text fg={terminalColors.textMuted}>|</text>
<text fg="#22cc44">top: {result()!.stats.mostImpactfulSkill}</text>
</Show>
</box>
<box flexDirection="row" gap={2} marginBottom={1}>
<text
fg={viewMode() === 'skills' ? terminalColors.accent : terminalColors.textMuted}
bold={viewMode() === 'skills'}
>
Skills ({result()?.skills?.length ?? 0})
</text>
<text
fg={viewMode() === 'files' ? terminalColors.accent : terminalColors.textMuted}
bold={viewMode() === 'files'}
>
Files ({result()?.files?.length ?? 0})
</text>
<text fg={terminalColors.textMuted}>(Tab to switch)</text>
</box>
<text fg={terminalColors.textMuted}>{'─'.repeat(Math.min(60, (props.cols ?? 80) - 4))}</text>
<Show when={items().length === 0}>
<EmptyState
title={viewMode() === 'skills' ? 'No skill lineage data' : 'No file lineage data'}
description="Execute skills to build lineage history"
/>
</Show>
<Show when={items().length > 0}>
<For each={visibleItems()}>
{(item, idx) => {
const absoluteIdx = () => windowStart() + idx();
const isSelected = () => absoluteIdx() === selectedIndex();
return (
<box flexDirection="column">
<Show when={viewMode() === 'skills'}>
{(() => {
const skill = item as SkillLineageEntry;
return (
<box flexDirection="row" gap={1}>
<text fg={isSelected() ? terminalColors.accent : terminalColors.textMuted}>
{isSelected() ? '>' : ' '}
</text>
<text fg={isSelected() ? terminalColors.text : terminalColors.textMuted} width={24}>
{skill.skillName}
</text>
<text fg={terminalColors.textMuted} width={8}>
{skill.executions}x
</text>
<text fg={terminalColors.textMuted} width={8}>
{formatDuration(skill.totalDurationMs)}
</text>
<text fg="#fbbf24" width={8}>
{skill.commits.length} commits
</text>
<text fg={terminalColors.textMuted}>
{skill.filesModified.length} files
</text>
</box>
);
})()}
</Show>
<Show when={viewMode() === 'files'}>
{(() => {
const file = item as FileLineage;
return (
<box flexDirection="row" gap={1}>
<text fg={isSelected() ? terminalColors.accent : terminalColors.textMuted}>
{isSelected() ? '>' : ' '}
</text>
<text fg={isSelected() ? terminalColors.text : terminalColors.textMuted} width={36}>
{file.path}
</text>
<text fg="#fbbf24" width={10}>
{file.commitCount} commits
</text>
<text fg={terminalColors.textMuted}>
{file.skills.join(', ')}
</text>
</box>
);
})()}
</Show>
</box>
);
}}
</For>
</Show>
</Show>
<text> </text>
<text fg={terminalColors.textMuted}>j/k navigate Tab switch view r refresh esc back</text>
</box>
);
}
+189
View File
@@ -0,0 +1,189 @@
import { createSignal, createEffect, Show, For, createMemo } from 'solid-js';
import { useKeyboard } from '@opentui/solid';
import { type Screen } from '../state/index.js';
import { terminalColors } from '../theme/colors.js';
import { Header } from '../components/Header.js';
import { Spinner } from '../components/Spinner.js';
import { EmptyState } from '../components/EmptyState.js';
import { execFile } from 'node:child_process';
interface TimelineProps {
onNavigate: (screen: Screen) => void;
cols?: number;
rows?: number;
}
interface TimelineEvent {
timestamp: string;
type: string;
source: string;
summary: string;
details?: Record<string, unknown>;
}
interface TimelineResult {
projectPath: string;
sessionDate: string;
events: TimelineEvent[];
totalCount: number;
}
function getTypeIcon(type: string): string {
switch (type) {
case 'skill_start': return '▶';
case 'skill_complete': return '✓';
case 'task_progress': return '◇';
case 'git_commit': return '●';
case 'observation': return '○';
case 'decision': return '◆';
case 'snapshot': return '◈';
default: return '•';
}
}
function getTypeColor(type: string): string {
switch (type) {
case 'skill_start': return '#22cc44';
case 'skill_complete': return '#22cc44';
case 'git_commit': return '#fbbf24';
case 'observation': return '#00bbcc';
case 'decision': return '#aa88ff';
case 'snapshot': return '#ff88aa';
default: return terminalColors.textMuted;
}
}
function formatTimestamp(ts: string): string {
try {
const d = new Date(ts);
if (isNaN(d.getTime())) return ts;
return d.toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true });
} catch {
return ts;
}
}
export function Timeline(props: TimelineProps) {
const [loading, setLoading] = createSignal(true);
const [result, setResult] = createSignal<TimelineResult | null>(null);
const [error, setError] = createSignal<string | null>(null);
const [selectedIndex, setSelectedIndex] = createSignal(0);
const rows = () => props.rows ?? 24;
const visibleCount = () => Math.max(1, rows() - 10);
const loadTimeline = () => {
setLoading(true);
setError(null);
try {
execFile('npx', ['skillkit', 'timeline', '--json'], {
timeout: 15000,
maxBuffer: 1024 * 1024,
}, (err, stdout, stderr) => {
setLoading(false);
if (err && !stdout) {
setError(stderr || err.message || 'Failed to load timeline');
return;
}
try {
const parsed = JSON.parse(stdout) as TimelineResult;
setResult(parsed);
} catch {
setError('Failed to parse timeline data');
}
});
} catch (err) {
setLoading(false);
setError(err instanceof Error ? err.message : 'Failed to load timeline');
}
};
createEffect(() => {
loadTimeline();
});
const events = createMemo(() => result()?.events ?? []);
const windowStart = createMemo(() => Math.max(0, selectedIndex() - visibleCount() + 1));
const visibleEvents = createMemo(() =>
events().slice(windowStart(), windowStart() + visibleCount())
);
useKeyboard((key: { name?: string }) => {
if (key.name === 'k' || key.name === 'up') {
setSelectedIndex(i => Math.max(0, i - 1));
} else if (key.name === 'j' || key.name === 'down') {
setSelectedIndex(i => events().length > 0 ? Math.min(events().length - 1, i + 1) : 0);
} else if (key.name === 'r') {
loadTimeline();
} else if (key.name === 'escape') {
props.onNavigate('home');
}
});
return (
<box flexDirection="column" padding={1}>
<Header
title="Timeline"
subtitle="unified event stream"
count={result()?.totalCount}
icon="▸"
/>
<Show when={loading()}>
<Spinner label="Loading timeline..." />
</Show>
<Show when={error()}>
<box flexDirection="column">
<text fg="#ff5555">Error: {error()}</text>
<text fg={terminalColors.textMuted}>Press r to retry</text>
</box>
</Show>
<Show when={!loading() && !error()}>
<Show when={events().length === 0}>
<EmptyState
title="No timeline events"
description="Events appear as you execute skills and make commits"
/>
</Show>
<Show when={events().length > 0}>
<For each={visibleEvents()}>
{(event, idx) => {
const absoluteIdx = () => windowStart() + idx();
const isSelected = () => absoluteIdx() === selectedIndex();
return (
<box flexDirection="column">
<box flexDirection="row" gap={1}>
<text fg={isSelected() ? terminalColors.accent : terminalColors.textMuted}>
{isSelected() ? '>' : ' '}
</text>
<text fg={terminalColors.textMuted} width={9}>
{formatTimestamp(event.timestamp)}
</text>
<text fg={getTypeColor(event.type)}>
{getTypeIcon(event.type)}
</text>
<text fg={isSelected() ? terminalColors.text : terminalColors.textMuted}>
{event.summary}
</text>
</box>
<Show when={isSelected() && event.source}>
<text fg={terminalColors.textMuted}>
{' '}source: {event.source}
</text>
</Show>
</box>
);
}}
</For>
</Show>
</Show>
<text> </text>
<text fg={terminalColors.textMuted}>j/k navigate r refresh esc back</text>
</box>
);
}
+3
View File
@@ -23,3 +23,6 @@ export { Help } from './Help.js';
export { Mesh } from './Mesh.js';
export { Message } from './Message.js';
export { Scan } from './Scan.js';
export { Timeline } from './Timeline.js';
export { Lineage } from './Lineage.js';
export { Handoff } from './Handoff.js';
+11 -1
View File
@@ -25,7 +25,8 @@ export type Screen =
| 'home' | 'browse' | 'installed' | 'marketplace' | 'recommend'
| 'translate' | 'context' | 'memory' | 'team' | 'plugins'
| 'methodology' | 'plan' | 'workflow' | 'execute' | 'history'
| 'sync' | 'settings' | 'help' | 'mesh' | 'message' | 'scan';
| 'sync' | 'settings' | 'help' | 'mesh' | 'message' | 'scan'
| 'timeline' | 'lineage' | 'handoff';
export const NAV_KEYS: Record<string, Screen> = {
h: 'home', m: 'marketplace', b: 'browse', w: 'workflow',
@@ -33,6 +34,7 @@ export const NAV_KEYS: Record<string, Screen> = {
c: 'context', e: 'memory', i: 'installed', s: 'sync',
a: 'team', p: 'plugins', o: 'methodology', n: 'plan',
',': 'settings', '/': 'help', 'g': 'mesh', 'j': 'message', 'z': 'scan',
l: 'timeline', v: 'lineage', f: 'handoff',
} as const;
export const STATUS_BAR_SHORTCUTS = 'b browse m market i installed s sync / help q quit';
@@ -85,6 +87,14 @@ export const SIDEBAR_NAV: SidebarSection[] = [
{ key: 'j', label: 'Messages', screen: 'message' },
],
},
{
section: 'Session',
items: [
{ key: 'l', label: 'Timeline', screen: 'timeline' },
{ key: 'v', label: 'Lineage', screen: 'lineage' },
{ key: 'f', label: 'Handoff', screen: 'handoff' },
],
},
{
section: 'More',
items: [
+1 -1
View File
@@ -2,7 +2,7 @@
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://skillkit.dev/schemas/skill.schema.json",
"title": "Skill Frontmatter",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://agenstskills.com)",
"description": "Schema for SKILL.md frontmatter validation (follows Agent Skills spec: https://skillkit.sh)",
"type": "object",
"required": ["name", "description"],
"properties": {
+2 -2
View File
@@ -8,7 +8,7 @@ export class ValidateCommand extends Command {
static override paths = [['validate'], ['v']];
static override usage = Command.Usage({
description: 'Validate skill(s) against the Agent Skills specification (agenstskills.com)',
description: 'Validate skill(s) against the Agent Skills specification (skillkit.sh)',
examples: [
['Validate a skill directory', '$0 validate ./my-skill'],
['Validate all skills in a directory', '$0 validate ./skills --all'],
@@ -77,7 +77,7 @@ export class ValidateCommand extends Command {
if (hasErrors) {
console.log(chalk.red('Validation failed'));
console.log(chalk.dim('See https://agenstskills.com for the complete format'));
console.log(chalk.dim('See https://skillkit.sh for the complete format'));
return 1;
}
+49 -40
View File
@@ -1,36 +1,41 @@
import { execSync } from 'node:child_process';
import { existsSync, rmSync } from 'node:fs';
import { join, basename } from 'node:path';
import { tmpdir } from 'node:os';
import { randomUUID } from 'node:crypto';
import type { GitProviderAdapter, CloneOptions } from './base.js';
import { parseShorthand } from './base.js';
import type { GitProvider, CloneResult } from '../core/types.js';
import { discoverSkills } from '../core/skills.js';
import { execFileSync } from "node:child_process";
import { existsSync, rmSync } from "node:fs";
import { join, basename } from "node:path";
import { tmpdir } from "node:os";
import { randomUUID } from "node:crypto";
import type { GitProviderAdapter, CloneOptions } from "./base.js";
import { parseShorthand } from "./base.js";
import type { GitProvider, CloneResult } from "../core/types.js";
import { discoverSkills } from "../core/skills.js";
export class BitbucketProvider implements GitProviderAdapter {
readonly type: GitProvider = 'bitbucket';
readonly name = 'Bitbucket';
readonly baseUrl = 'https://bitbucket.org';
readonly type: GitProvider = "bitbucket";
readonly name = "Bitbucket";
readonly baseUrl = "https://bitbucket.org";
parseSource(source: string): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith('https://bitbucket.org/')) {
const path = source.replace('https://bitbucket.org/', '').replace(/\.git$/, '');
parseSource(
source: string,
): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith("https://bitbucket.org/")) {
const path = source
.replace("https://bitbucket.org/", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('git@bitbucket.org:')) {
const path = source.replace('git@bitbucket.org:', '').replace(/\.git$/, '');
if (source.startsWith("git@bitbucket.org:")) {
const path = source
.replace("git@bitbucket.org:", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('bitbucket:')) {
return parseShorthand(source.replace('bitbucket:', ''));
if (source.startsWith("bitbucket:")) {
return parseShorthand(source.replace("bitbucket:", ""));
}
if (source.startsWith('bitbucket.org/')) {
return parseShorthand(source.replace('bitbucket.org/', ''));
if (source.startsWith("bitbucket.org/")) {
return parseShorthand(source.replace("bitbucket.org/", ""));
}
return null;
@@ -38,10 +43,10 @@ export class BitbucketProvider implements GitProviderAdapter {
matches(source: string): boolean {
return (
source.startsWith('https://bitbucket.org/') ||
source.startsWith('git@bitbucket.org:') ||
source.startsWith('bitbucket:') ||
source.startsWith('bitbucket.org/')
source.startsWith("https://bitbucket.org/") ||
source.startsWith("git@bitbucket.org:") ||
source.startsWith("bitbucket:") ||
source.startsWith("bitbucket.org/")
);
}
@@ -53,31 +58,36 @@ export class BitbucketProvider implements GitProviderAdapter {
return `git@bitbucket.org:${owner}/${repo}.git`;
}
async clone(source: string, _targetDir: string, options: CloneOptions = {}): Promise<CloneResult> {
async clone(
source: string,
_targetDir: string,
options: CloneOptions = {},
): Promise<CloneResult> {
const parsed = this.parseSource(source);
if (!parsed) {
return { success: false, error: `Invalid Bitbucket source: ${source}` };
}
const { owner, repo, subpath } = parsed;
const cloneUrl = options.ssh ? this.getSshUrl(owner, repo) : this.getCloneUrl(owner, repo);
const cloneUrl = options.ssh
? this.getSshUrl(owner, repo)
: this.getCloneUrl(owner, repo);
const tempDir = join(tmpdir(), `skillkit-${randomUUID()}`);
try {
const args = ['clone'];
const args = ["clone"];
if (options.depth) {
args.push('--depth', String(options.depth));
args.push("--depth", String(options.depth));
}
if (options.branch) {
args.push('--branch', options.branch);
args.push("--branch", options.branch);
}
args.push(cloneUrl, tempDir);
execSync(`git ${args.join(' ')}`, {
stdio: ['pipe', 'pipe', 'pipe'],
encoding: 'utf-8',
execFileSync("git", args, {
stdio: ["pipe", "pipe", "pipe"],
encoding: "utf-8",
});
const searchDir = subpath ? join(tempDir, subpath) : tempDir;
@@ -85,17 +95,16 @@ export class BitbucketProvider implements GitProviderAdapter {
return {
success: true,
path: searchDir,
tempRoot: tempDir,
skills: skills.map(s => s.name),
discoveredSkills: skills.map(s => ({
path: searchDir,
tempRoot: tempDir,
skills: skills.map((s) => s.name),
discoveredSkills: skills.map((s) => ({
name: s.name,
dirName: basename(s.path),
path: s.path,
})),
};
} catch (error) {
if (existsSync(tempDir)) {
rmSync(tempDir, { recursive: true, force: true });
}
+43 -37
View File
@@ -1,31 +1,34 @@
import { execSync } from 'node:child_process';
import { existsSync, rmSync } from 'node:fs';
import { join, basename } from 'node:path';
import { tmpdir } from 'node:os';
import { randomUUID } from 'node:crypto';
import type { GitProviderAdapter, CloneOptions } from './base.js';
import { parseShorthand, isGitUrl } from './base.js';
import type { GitProvider, CloneResult } from '../core/types.js';
import { discoverSkills } from '../core/skills.js';
import { execFileSync } from "node:child_process";
import { existsSync, rmSync } from "node:fs";
import { join, basename } from "node:path";
import { tmpdir } from "node:os";
import { randomUUID } from "node:crypto";
import type { GitProviderAdapter, CloneOptions } from "./base.js";
import { parseShorthand, isGitUrl } from "./base.js";
import type { GitProvider, CloneResult } from "../core/types.js";
import { discoverSkills } from "../core/skills.js";
export class GitHubProvider implements GitProviderAdapter {
readonly type: GitProvider = 'github';
readonly name = 'GitHub';
readonly baseUrl = 'https://github.com';
readonly type: GitProvider = "github";
readonly name = "GitHub";
readonly baseUrl = "https://github.com";
parseSource(source: string): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith('https://github.com/')) {
const path = source.replace('https://github.com/', '').replace(/\.git$/, '');
parseSource(
source: string,
): { owner: string; repo: string; subpath?: string } | null {
if (source.startsWith("https://github.com/")) {
const path = source
.replace("https://github.com/", "")
.replace(/\.git$/, "");
return parseShorthand(path);
}
if (source.startsWith('git@github.com:')) {
const path = source.replace('git@github.com:', '').replace(/\.git$/, '');
if (source.startsWith("git@github.com:")) {
const path = source.replace("git@github.com:", "").replace(/\.git$/, "");
return parseShorthand(path);
}
if (!isGitUrl(source) && !source.includes(':')) {
if (!isGitUrl(source) && !source.includes(":")) {
return parseShorthand(source);
}
@@ -34,10 +37,9 @@ export class GitHubProvider implements GitProviderAdapter {
matches(source: string): boolean {
return (
source.startsWith('https://github.com/') ||
source.startsWith('git@github.com:') ||
(!isGitUrl(source) && !source.includes(':') && source.includes('/'))
source.startsWith("https://github.com/") ||
source.startsWith("git@github.com:") ||
(!isGitUrl(source) && !source.includes(":") && source.includes("/"))
);
}
@@ -49,31 +51,36 @@ export class GitHubProvider implements GitProviderAdapter {
return `git@github.com:${owner}/${repo}.git`;
}
async clone(source: string, _targetDir: string, options: CloneOptions = {}): Promise<CloneResult> {
async clone(
source: string,
_targetDir: string,
options: CloneOptions = {},
): Promise<CloneResult> {
const parsed = this.parseSource(source);
if (!parsed) {
return { success: false, error: `Invalid GitHub source: ${source}` };
}
const { owner, repo, subpath } = parsed;
const cloneUrl = options.ssh ? this.getSshUrl(owner, repo) : this.getCloneUrl(owner, repo);
const cloneUrl = options.ssh
? this.getSshUrl(owner, repo)
: this.getCloneUrl(owner, repo);
const tempDir = join(tmpdir(), `skillkit-${randomUUID()}`);
try {
const args = ['clone'];
const args = ["clone"];
if (options.depth) {
args.push('--depth', String(options.depth));
args.push("--depth", String(options.depth));
}
if (options.branch) {
args.push('--branch', options.branch);
args.push("--branch", options.branch);
}
args.push(cloneUrl, tempDir);
execSync(`git ${args.join(' ')}`, {
stdio: ['pipe', 'pipe', 'pipe'],
encoding: 'utf-8',
execFileSync("git", args, {
stdio: ["pipe", "pipe", "pipe"],
encoding: "utf-8",
});
const searchDir = subpath ? join(tempDir, subpath) : tempDir;
@@ -81,17 +88,16 @@ export class GitHubProvider implements GitProviderAdapter {
return {
success: true,
path: searchDir,
tempRoot: tempDir,
skills: skills.map(s => s.name),
discoveredSkills: skills.map(s => ({
path: searchDir,
tempRoot: tempDir,
skills: skills.map((s) => s.name),
discoveredSkills: skills.map((s) => ({
name: s.name,
dirName: basename(s.path),
path: s.path,
})),
};
} catch (error) {
if (existsSync(tempDir)) {
rmSync(tempDir, { recursive: true, force: true });
}

Some files were not shown because too many files have changed in this diff Show More