Compare commits

..
6 Commits
Author SHA1 Message Date
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
55 changed files with 3608 additions and 126 deletions
+10
View File
@@ -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
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit",
"version": "1.19.0",
"version": "1.19.1",
"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));
+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
@@ -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.1",
"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>
+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>
+20 -44
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')}
@@ -99,12 +81,12 @@ export default function App(): React.ReactElement {
Generator
</a>
<a
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
href="https://agenstskills.com/docs"
target="_blank"
rel="noopener noreferrer"
className="text-zinc-500 hover:text-white transition-colors"
>
Extension
Docs
</a>
</div>
<div className="flex items-center gap-3 sm:gap-4">
@@ -114,12 +96,6 @@ export default function App(): React.ReactElement {
>
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"
@@ -192,39 +168,39 @@ export default function App(): React.ReactElement {
<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 />
{/* 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="https://agenstskills.com/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>
{/* 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 />
@@ -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',
+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
+14 -14
View File
@@ -109,13 +109,13 @@ 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;
@@ -125,18 +125,18 @@ export function Features(): React.ReactElement {
<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="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">
+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">
+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>
);
}
+1 -1
View File
@@ -1,7 +1,7 @@
{
"name": "skillkit",
"private": true,
"version": "1.19.0",
"version": "1.19.1",
"type": "module",
"scripts": {
"dev": "vite",
Binary file not shown.
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "skillkit-monorepo",
"version": "1.19.0",
"version": "1.19.1",
"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.1",
"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.1",
"description": "REST API server for SkillKit skill discovery",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/cli",
"version": "1.19.0",
"version": "1.19.1",
"description": "CLI commands for SkillKit",
"type": "module",
"main": "./dist/index.js",
+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;
}
}
+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.1",
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
"type": "module",
"main": "./dist/index.js",
@@ -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;
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/extension",
"version": "1.19.0",
"version": "1.19.1",
"private": true,
"description": "Chrome extension to save any webpage as an AI agent skill",
"type": "module",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/mcp-memory",
"version": "1.19.0",
"version": "1.19.1",
"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.1",
"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.1",
"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.1",
"description": "Peer mesh network for multi-machine agent distribution",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/messaging",
"version": "1.19.0",
"version": "1.19.1",
"description": "Inter-agent messaging system for SkillKit",
"type": "module",
"main": "./dist/index.js",
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "@skillkit/resources",
"version": "1.19.0",
"version": "1.19.1",
"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.1",
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
"type": "module",
"main": "./dist/index.js",
+4
View File
@@ -9,6 +9,7 @@ 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';
@@ -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: [