Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
86c1e5d8f9 | ||
|
|
9930096242 | ||
|
|
24ff833265 | ||
|
|
12ac7356f8 | ||
|
|
53b3f4f839 | ||
|
|
896eff184c | ||
|
|
407e8215f2 | ||
|
|
dd4ec56a1a | ||
|
|
e9bb9fbd0d | ||
|
|
ee54bf1545 | ||
|
|
f097ec7ad7 |
@@ -65,3 +65,4 @@ skillkit.yaml
|
||||
CLAUDE.md
|
||||
prd.md
|
||||
.vercel
|
||||
packages/extension/store-assets/skillkit-extension.zip
|
||||
|
||||
@@ -17,7 +17,7 @@
|
||||
|
||||
**SkillKit** is the open source package manager for AI agent skills. Write a skill once, deploy it to **44 agents** — Claude, Cursor, Copilot, Windsurf, Devin, Codex, and 38 more. No rewrites. 15,000+ skills in the marketplace.
|
||||
|
||||
[Website](https://agenstskills.com) · [Docs](https://agenstskills.com/docs) · [API Explorer](https://agenstskills.com/api) · [npm](https://www.npmjs.com/package/skillkit)
|
||||
[Website](https://agenstskills.com) · [Docs](https://agenstskills.com/docs) · [API Explorer](https://agenstskills.com/api) · [Chrome Extension](https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme) · [npm](https://www.npmjs.com/package/skillkit)
|
||||
|
||||
</div>
|
||||
|
||||
@@ -181,6 +181,18 @@ git commit -m "add team skills"
|
||||
|
||||
Team members run `skillkit manifest install` and they're in sync.
|
||||
|
||||
### Chrome Extension
|
||||
|
||||
Save any webpage as a skill directly from your browser. No server needed.
|
||||
|
||||
1. Build: `pnpm --filter @skillkit/extension build`
|
||||
2. Chrome → `chrome://extensions` → Load unpacked → `packages/extension/dist/`
|
||||
3. Click the extension icon or right-click → "Save page as Skill"
|
||||
|
||||
The extension extracts page content as markdown, generates SKILL.md with auto-detected tags, and downloads it. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents.
|
||||
|
||||
[Extension docs](https://agenstskills.com/docs/chrome-extension)
|
||||
|
||||
### Interactive TUI
|
||||
|
||||
```bash
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Supercharge AI coding agents with portable skills. Install, translate, and share skills across Claude Code, Cursor, Codex, Copilot & 13 more",
|
||||
"type": "module",
|
||||
"bin": {
|
||||
|
||||
@@ -104,6 +104,11 @@ import {
|
||||
SkillMdCheckCommand,
|
||||
ServeCommand,
|
||||
ScanCommand,
|
||||
SaveCommand,
|
||||
AgentsMdCommand,
|
||||
AgentsMdInitCommand,
|
||||
AgentsMdSyncCommand,
|
||||
AgentsMdShowCommand,
|
||||
} from '@skillkit/cli';
|
||||
|
||||
const __filename = fileURLToPath(import.meta.url);
|
||||
@@ -233,5 +238,10 @@ cli.register(SkillMdCheckCommand);
|
||||
|
||||
cli.register(ServeCommand);
|
||||
cli.register(ScanCommand);
|
||||
cli.register(SaveCommand);
|
||||
cli.register(AgentsMdCommand);
|
||||
cli.register(AgentsMdInitCommand);
|
||||
cli.register(AgentsMdSyncCommand);
|
||||
cli.register(AgentsMdShowCommand);
|
||||
|
||||
cli.runExit(process.argv.slice(2));
|
||||
|
||||
@@ -0,0 +1,119 @@
|
||||
---
|
||||
title: Chrome Extension
|
||||
description: Save any webpage as an AI agent skill from your browser
|
||||
---
|
||||
|
||||
# Chrome Extension
|
||||
|
||||
Save any webpage as a SKILL.md directly from your browser. No server needed.
|
||||
|
||||
## Install
|
||||
|
||||
1. Download the extension from the [releases page](https://github.com/rohitg00/skillkit/releases)
|
||||
2. Open `chrome://extensions` in Chrome
|
||||
3. Enable "Developer mode" (top right)
|
||||
4. Click "Load unpacked" and select the `packages/extension/dist/` folder
|
||||
|
||||
Or build from source:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/rohitg00/skillkit.git
|
||||
cd skillkit
|
||||
pnpm install && pnpm --filter @skillkit/extension build
|
||||
```
|
||||
|
||||
Then load `packages/extension/dist/` as an unpacked extension.
|
||||
|
||||
## Usage
|
||||
|
||||
### Popup
|
||||
|
||||
1. Navigate to any webpage
|
||||
2. Click the SkillKit extension icon
|
||||
3. Optionally enter a custom skill name
|
||||
4. Click **Save as Skill**
|
||||
|
||||
The extension extracts the page content as markdown, generates a SKILL.md with YAML frontmatter and auto-detected tags, and downloads it to your `Downloads/skillkit-skills/` folder.
|
||||
|
||||
### Context Menu
|
||||
|
||||
Right-click on any page:
|
||||
|
||||
- **Save page as Skill** — saves the entire page
|
||||
- **Save selection as Skill** — saves only the selected text
|
||||
|
||||
### Making Skills Available to Agents
|
||||
|
||||
After downloading, install the skill so all agents can use it:
|
||||
|
||||
```bash
|
||||
skillkit install ~/Downloads/skillkit-skills/my-skill
|
||||
```
|
||||
|
||||
Or copy directly:
|
||||
|
||||
```bash
|
||||
cp -r ~/Downloads/skillkit-skills/my-skill ~/.skillkit/skills/
|
||||
skillkit sync
|
||||
```
|
||||
|
||||
## How It Works
|
||||
|
||||
The extension runs entirely in the browser:
|
||||
|
||||
1. **Content script** extracts page content using [Turndown](https://github.com/mixmark-io/turndown) to convert HTML to clean markdown. It targets `<article>`, `<main>`, or `<body>` and strips scripts, nav, footer, and iframes.
|
||||
|
||||
2. **Background service worker** generates the SKILL.md:
|
||||
- Slugifies the page title into a skill name
|
||||
- Builds YAML frontmatter (name, description, source URL, timestamp)
|
||||
- Auto-detects tags from 40+ tech keywords (react, typescript, docker, kubernetes, etc.)
|
||||
- Downloads via `chrome.downloads` API
|
||||
|
||||
3. **No server required** — the `POST /save` API endpoint exists for CLI users (`skillkit save`), but the extension works independently.
|
||||
|
||||
## Permissions
|
||||
|
||||
| Permission | Why |
|
||||
|-----------|-----|
|
||||
| `contextMenus` | Right-click "Save as Skill" menu items |
|
||||
| `activeTab` | Access current page URL and title |
|
||||
| `storage` | Persist extension preferences |
|
||||
| `downloads` | Save SKILL.md files to disk |
|
||||
|
||||
No `host_permissions` needed. The extension never sends data to any server.
|
||||
|
||||
## Generated SKILL.md Format
|
||||
|
||||
```yaml
|
||||
---
|
||||
name: react-performance-tips
|
||||
description: Optimizing React rendering with memo and useMemo
|
||||
tags:
|
||||
- react
|
||||
- javascript
|
||||
- testing
|
||||
metadata:
|
||||
source: https://example.com/react-performance
|
||||
savedAt: 2026-02-10T09:00:00.000Z
|
||||
---
|
||||
|
||||
# React Performance Tips
|
||||
|
||||
The extracted markdown content of the page...
|
||||
```
|
||||
|
||||
## Building from Source
|
||||
|
||||
The extension uses tsup to bundle TypeScript into IIFE format for browser compatibility:
|
||||
|
||||
```bash
|
||||
pnpm --filter @skillkit/extension build
|
||||
```
|
||||
|
||||
Output goes to `packages/extension/dist/` with:
|
||||
- `background.global.js` — Service worker (5KB)
|
||||
- `content.global.js` — Content script with Turndown (23KB)
|
||||
- `popup.global.js` — Popup UI logic (3KB)
|
||||
- `popup.html` + `popup.css` — Monochromatic UI
|
||||
- `manifest.json` — Chrome Manifest V3
|
||||
- `icons/` — 16/48/128px PNG icons
|
||||
@@ -3,6 +3,7 @@
|
||||
"pages": [
|
||||
"index",
|
||||
"installation",
|
||||
"chrome-extension",
|
||||
"quickstart",
|
||||
"tui",
|
||||
"skills",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-docs",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"private": true,
|
||||
"scripts": {
|
||||
"build": "next build",
|
||||
|
||||
@@ -29,7 +29,7 @@
|
||||
|
||||
<g transform="translate(890, 58)">
|
||||
<rect width="250" height="40" fill="url(#ph-badge)" stroke="#444" stroke-width="1" rx="20"/>
|
||||
<circle cx="28" cy="20" r="14" fill="#da552f"/>
|
||||
<circle cx="28" cy="20" r="14" fill="none" stroke="#666" stroke-width="1.5"/>
|
||||
<text x="28" y="25" font-family="system-ui, sans-serif" font-size="16" font-weight="700" fill="white" text-anchor="middle">P</text>
|
||||
<text x="54" y="16" font-family="system-ui, sans-serif" font-size="9" font-weight="600" fill="#888" letter-spacing="1">PRODUCT HUNT</text>
|
||||
<text x="54" y="30" font-family="system-ui, sans-serif" font-size="13" font-weight="700" fill="white">#3 Product of the Day</text>
|
||||
|
||||
|
Before Width: | Height: | Size: 3.9 KiB After Width: | Height: | Size: 3.9 KiB |
@@ -98,6 +98,14 @@ export default function App(): React.ReactElement {
|
||||
>
|
||||
Generator
|
||||
</a>
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="text-zinc-500 hover:text-white transition-colors"
|
||||
>
|
||||
Extension
|
||||
</a>
|
||||
</div>
|
||||
<div className="flex items-center gap-3 sm:gap-4">
|
||||
<a
|
||||
@@ -169,21 +177,6 @@ export default function App(): React.ReactElement {
|
||||
</svg>
|
||||
<span className="text-white font-medium">{stats.stars || '—'}</span>
|
||||
</a>
|
||||
<span className="text-zinc-800 hidden sm:inline">·</span>
|
||||
<a
|
||||
href="https://www.producthunt.com/products/skillkit-2?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-skillkit-2"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="hidden sm:inline-flex items-center hover:opacity-80 transition-opacity"
|
||||
>
|
||||
<img
|
||||
src="https://api.producthunt.com/widgets/embed-image/v1/top-post-badge.svg?post_id=1071813&theme=dark&period=daily"
|
||||
alt="Skillkit - The package manager for AI agent skills | Product Hunt"
|
||||
width="250"
|
||||
height="54"
|
||||
style={{ height: '28px', width: 'auto' }}
|
||||
/>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -107,10 +107,6 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
}
|
||||
}
|
||||
|
||||
function openGitHub(): void {
|
||||
window.open('https://github.com/rohitg00/skillkit', '_blank', 'noopener,noreferrer');
|
||||
}
|
||||
|
||||
const isTyping = visibleLines < TERMINAL_LINES.length && TERMINAL_LINES[visibleLines].type === 'cmd';
|
||||
const isComplete = visibleLines >= TERMINAL_LINES.length;
|
||||
|
||||
@@ -119,10 +115,22 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
<div className="absolute inset-0 bg-gradient-to-b from-zinc-900/50 to-transparent pointer-events-none"></div>
|
||||
|
||||
<div className="mx-auto max-w-5xl px-4 sm:px-6 lg:px-8 pt-8 pb-10 relative">
|
||||
<div className="hidden lg:block mb-6 overflow-hidden">
|
||||
<pre className="text-zinc-600 text-[10px] leading-none font-mono select-none whitespace-pre" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
|
||||
<div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3 mb-4 lg:mb-6">
|
||||
<pre className="hidden sm:block text-zinc-600 text-[6px] sm:text-[8px] lg:text-[10px] leading-none font-mono select-none whitespace-pre overflow-x-auto" style={{ fontFamily: 'JetBrains Mono, Consolas, monospace' }}>
|
||||
{ASCII_LOGO}
|
||||
</pre>
|
||||
<a
|
||||
href="https://www.producthunt.com/products/skillkit-2?embed=true&utm_source=badge-top-post-badge&utm_medium=badge&utm_campaign=badge-skillkit-2"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 sm:gap-3 bg-zinc-900/80 border border-zinc-800 hover:border-zinc-600 transition-colors rounded-full px-3 sm:px-4 py-1.5 sm:py-2 group shrink-0 self-start"
|
||||
>
|
||||
<span className="flex items-center justify-center w-6 h-6 sm:w-8 sm:h-8 rounded-full border border-zinc-600 bg-transparent text-white font-bold text-xs sm:text-sm">P</span>
|
||||
<span className="flex flex-col">
|
||||
<span className="text-[8px] sm:text-[10px] font-semibold text-zinc-500 tracking-wider uppercase leading-tight">Product Hunt</span>
|
||||
<span className="text-[11px] sm:text-sm font-bold text-white group-hover:text-zinc-300 transition-colors leading-tight">#3 Product of the Day</span>
|
||||
</span>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<div className="grid grid-cols-1 md:grid-cols-2 gap-6 lg:gap-8 items-start">
|
||||
@@ -161,9 +169,24 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
)}
|
||||
</span>
|
||||
</button>
|
||||
<button
|
||||
onClick={openGitHub}
|
||||
className="inline-flex items-center gap-2 border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors group"
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit/tree/main/packages/extension#readme"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex items-center gap-2 bg-white text-black border border-zinc-300 px-3 py-2 hover:bg-zinc-200 transition-colors font-mono text-sm font-semibold"
|
||||
>
|
||||
<svg className="w-4 h-4" viewBox="0 0 24 24" fill="none">
|
||||
<circle cx="12" cy="12" r="10" fill="#09090b"/>
|
||||
<circle cx="12" cy="12" r="4.5" fill="white"/>
|
||||
<path d="M12 2v5.5M12 16.5V22M2 12h5.5M16.5 12H22" stroke="white" strokeWidth="1.5"/>
|
||||
</svg>
|
||||
Add to Chrome
|
||||
</a>
|
||||
<a
|
||||
href="https://github.com/rohitg00/skillkit"
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="sm:hidden inline-flex items-center gap-2 border border-zinc-700 px-3 py-2 hover:border-zinc-500 transition-colors group"
|
||||
>
|
||||
<svg className="w-4 h-4 text-zinc-400 group-hover:text-white transition-colors" fill="currentColor" viewBox="0 0 24 24">
|
||||
<path fillRule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.531 1.032 1.531 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z" clipRule="evenodd" />
|
||||
@@ -178,7 +201,7 @@ export function Hero({ version, stars }: HeroProps): React.ReactElement {
|
||||
<span className="font-mono text-sm text-white font-medium">{stars}</span>
|
||||
</>
|
||||
)}
|
||||
</button>
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "skillkit",
|
||||
"private": true,
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "skillkit-monorepo",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"private": true,
|
||||
"description": "The package manager for AI agent skills — install, translate, share across 32 coding agents",
|
||||
"type": "module",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/agents",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Agent adapters for SkillKit - supports 32 AI coding agents",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/api",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "REST API server for SkillKit skill discovery",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -0,0 +1,95 @@
|
||||
import { Hono } from 'hono';
|
||||
import { ContentExtractor, SkillGenerator, AutoTagger } from '@skillkit/core';
|
||||
|
||||
interface SaveRequest {
|
||||
url?: string;
|
||||
text?: string;
|
||||
name?: string;
|
||||
global?: boolean;
|
||||
}
|
||||
|
||||
const MAX_TEXT_LENGTH = 500_000;
|
||||
|
||||
const BLOCKED_HOSTS = new Set(['localhost', '127.0.0.1', '[::1]', '::1', '0.0.0.0']);
|
||||
|
||||
function isAllowedUrl(url: string): boolean {
|
||||
try {
|
||||
const parsed = new URL(url);
|
||||
if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') return false;
|
||||
|
||||
const hostname = parsed.hostname.toLowerCase();
|
||||
const bare = hostname.replace(/^\[|\]$/g, '');
|
||||
|
||||
if (BLOCKED_HOSTS.has(hostname) || BLOCKED_HOSTS.has(bare)) return false;
|
||||
if (bare.startsWith('::ffff:')) return isAllowedUrl(`http://${bare.slice(7)}`);
|
||||
if (/^127\./.test(bare) || /^0\./.test(bare)) return false;
|
||||
if (bare.startsWith('10.') || bare.startsWith('192.168.')) return false;
|
||||
if (/^172\.(1[6-9]|2\d|3[01])\./.test(bare)) return false;
|
||||
if (bare.startsWith('169.254.')) return false;
|
||||
if (bare.startsWith('fe80:') || bare.startsWith('fc') || bare.startsWith('fd')) return false;
|
||||
if (/^(22[4-9]|23\d|24\d|25[0-5])\./.test(bare)) return false;
|
||||
if (bare.startsWith('ff')) return false;
|
||||
return true;
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function saveRoutes() {
|
||||
const app = new Hono();
|
||||
const extractor = new ContentExtractor();
|
||||
const generator = new SkillGenerator();
|
||||
const tagger = new AutoTagger();
|
||||
|
||||
app.post('/save', async (c) => {
|
||||
let body: SaveRequest;
|
||||
try {
|
||||
body = await c.req.json();
|
||||
} catch {
|
||||
return c.json({ error: 'Invalid JSON body' }, 400);
|
||||
}
|
||||
|
||||
if (!body.url && !body.text) {
|
||||
return c.json({ error: 'Either "url" or "text" is required' }, 400);
|
||||
}
|
||||
|
||||
if (body.url && !isAllowedUrl(body.url)) {
|
||||
return c.json({ error: 'URL must be a public HTTP(S) address' }, 400);
|
||||
}
|
||||
|
||||
if (body.text && body.text.length > MAX_TEXT_LENGTH) {
|
||||
return c.json({ error: `Text exceeds maximum length of ${MAX_TEXT_LENGTH} characters` }, 400);
|
||||
}
|
||||
|
||||
try {
|
||||
const content = body.url
|
||||
? await extractor.extractFromUrl(body.url)
|
||||
: extractor.extractFromText(body.text!);
|
||||
|
||||
const result = generator.generate(content, {
|
||||
name: body.name,
|
||||
global: body.global ?? true,
|
||||
});
|
||||
|
||||
return c.json({
|
||||
name: result.name,
|
||||
skillPath: result.skillPath,
|
||||
skillMd: result.skillMd,
|
||||
tags: tagger.detectTags(content),
|
||||
});
|
||||
} catch (err) {
|
||||
const message = err instanceof Error ? err.message : 'Unknown error';
|
||||
const isTimeout =
|
||||
(err instanceof DOMException && err.name === 'TimeoutError') ||
|
||||
(err instanceof Error && (err.name === 'TimeoutError' || err.name === 'AbortError'));
|
||||
|
||||
if (isTimeout) {
|
||||
return c.json({ error: `Fetch timeout: ${message}` }, 504);
|
||||
}
|
||||
|
||||
return c.json({ error: `Extraction failed: ${message}` }, 422);
|
||||
}
|
||||
});
|
||||
|
||||
return app;
|
||||
}
|
||||
@@ -8,6 +8,7 @@ import { skillRoutes } from './routes/skills.js';
|
||||
import { trendingRoutes } from './routes/trending.js';
|
||||
import { categoryRoutes } from './routes/categories.js';
|
||||
import { docsRoutes } from './routes/docs.js';
|
||||
import { saveRoutes } from './routes/save.js';
|
||||
import type { ApiSkill, SearchResponse } from './types.js';
|
||||
|
||||
export interface ServerOptions {
|
||||
@@ -37,6 +38,7 @@ export function createApp(options: ServerOptions = {}) {
|
||||
app.route('/', trendingRoutes(skills));
|
||||
app.route('/', categoryRoutes(skills));
|
||||
app.route('/', docsRoutes());
|
||||
app.route('/', saveRoutes());
|
||||
|
||||
return { app, cache };
|
||||
}
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/cli",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "CLI commands for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -0,0 +1,123 @@
|
||||
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { Command } from 'clipanion';
|
||||
import { AgentsMdGenerator, AgentsMdParser } from '@skillkit/core';
|
||||
|
||||
export class AgentsMdCommand extends Command {
|
||||
static override paths = [['agents']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Manage AGENTS.md for project-specific agent context',
|
||||
details: `
|
||||
Sub-commands:
|
||||
agents init - Generate initial AGENTS.md
|
||||
agents sync - Update managed sections in existing AGENTS.md
|
||||
agents show - Display current AGENTS.md content
|
||||
`,
|
||||
examples: [
|
||||
['Generate AGENTS.md', '$0 agents init'],
|
||||
['Update skills section', '$0 agents sync'],
|
||||
['Show AGENTS.md', '$0 agents show'],
|
||||
],
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
this.context.stdout.write(this.cli.usage(AgentsMdCommand, { detailed: true }));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentsMdInitCommand extends Command {
|
||||
static override paths = [['agents', 'init']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Generate initial AGENTS.md in current directory',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = process.cwd();
|
||||
const agentsPath = join(projectPath, 'AGENTS.md');
|
||||
|
||||
if (existsSync(agentsPath)) {
|
||||
console.log(chalk.yellow('AGENTS.md already exists. Use `skillkit agents sync` to update.'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const generator = new AgentsMdGenerator({ projectPath });
|
||||
const result = generator.generate();
|
||||
|
||||
console.log(chalk.dim('Preview:'));
|
||||
console.log('');
|
||||
console.log(result.content);
|
||||
|
||||
writeFileSync(agentsPath, result.content, 'utf-8');
|
||||
console.log(chalk.green(`Created ${agentsPath}`));
|
||||
return 0;
|
||||
} catch (err) {
|
||||
console.log(chalk.red(`Failed to generate AGENTS.md: ${err instanceof Error ? err.message : String(err)}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentsMdSyncCommand extends Command {
|
||||
static override paths = [['agents', 'sync']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Update managed sections in existing AGENTS.md',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const projectPath = process.cwd();
|
||||
const agentsPath = join(projectPath, 'AGENTS.md');
|
||||
|
||||
if (!existsSync(agentsPath)) {
|
||||
console.log(chalk.yellow('No AGENTS.md found. Run `skillkit agents init` first.'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
try {
|
||||
const existing = readFileSync(agentsPath, 'utf-8');
|
||||
const parser = new AgentsMdParser();
|
||||
|
||||
if (!parser.hasManagedSections(existing)) {
|
||||
console.log(chalk.yellow('No managed sections found in AGENTS.md. Nothing to update.'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
const generator = new AgentsMdGenerator({ projectPath });
|
||||
const result = generator.generate();
|
||||
const managedSections = result.sections.filter(s => s.managed);
|
||||
const updated = parser.updateManagedSections(existing, managedSections);
|
||||
|
||||
writeFileSync(agentsPath, updated, 'utf-8');
|
||||
console.log(chalk.green(`Updated ${managedSections.length} managed section(s) in AGENTS.md`));
|
||||
return 0;
|
||||
} catch (err) {
|
||||
console.log(chalk.red(`Failed to sync AGENTS.md: ${err instanceof Error ? err.message : String(err)}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
export class AgentsMdShowCommand extends Command {
|
||||
static override paths = [['agents', 'show']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Display current AGENTS.md content',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const agentsPath = join(process.cwd(), 'AGENTS.md');
|
||||
|
||||
if (!existsSync(agentsPath)) {
|
||||
console.log(chalk.yellow('No AGENTS.md found. Run `skillkit agents init` to create one.'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
console.log(readFileSync(agentsPath, 'utf-8'));
|
||||
return 0;
|
||||
}
|
||||
}
|
||||
@@ -119,3 +119,10 @@ export { SkillMdValidateCommand, SkillMdInitCommand, SkillMdCheckCommand } from
|
||||
// API server
|
||||
export { ServeCommand } from './serve.js';
|
||||
export { ScanCommand } from './scan.js';
|
||||
export { SaveCommand } from './save.js';
|
||||
export {
|
||||
AgentsMdCommand,
|
||||
AgentsMdInitCommand,
|
||||
AgentsMdSyncCommand,
|
||||
AgentsMdShowCommand,
|
||||
} from './agents-md.js';
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
import { existsSync, mkdirSync, cpSync, rmSync, symlinkSync } from 'node:fs';
|
||||
import { existsSync, mkdirSync, cpSync, rmSync, symlinkSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { execFile } from 'node:child_process';
|
||||
import { promisify } from 'node:util';
|
||||
|
||||
const execFileAsync = promisify(execFile);
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { detectProvider, isLocalPath, getProvider, evaluateSkillDirectory, SkillScanner, formatSummary, Severity } from '@skillkit/core';
|
||||
import { detectProvider, isLocalPath, getProvider, evaluateSkillDirectory, SkillScanner, formatSummary, Severity, WellKnownProvider, AgentsMdParser, AgentsMdGenerator } from '@skillkit/core';
|
||||
import type { SkillMetadata, GitProvider, AgentType } from '@skillkit/core';
|
||||
import { isPathInside } from '@skillkit/core';
|
||||
import { getAdapter, detectAgent, getAllAdapters } from '@skillkit/agents';
|
||||
@@ -109,6 +109,25 @@ export class InstallCommand extends Command {
|
||||
}
|
||||
|
||||
let providerAdapter = detectProvider(this.source);
|
||||
let result: { success: boolean; path?: string; tempRoot?: string; error?: string; skills?: string[]; discoveredSkills?: Array<{ name: string; dirName: string; path: string }> } | null = null;
|
||||
|
||||
const isUrl = this.source.startsWith('http://') || this.source.startsWith('https://');
|
||||
if (isUrl && !this.provider && !providerAdapter) {
|
||||
s.start('Checking for well-known skills...');
|
||||
const wellKnown = new WellKnownProvider();
|
||||
const discovery = await wellKnown.discoverFromUrl(this.source);
|
||||
if (discovery.success) {
|
||||
s.stop(`Found ${discovery.skills?.length || 0} skill(s) via well-known discovery`);
|
||||
providerAdapter = wellKnown;
|
||||
result = discovery;
|
||||
} else {
|
||||
s.stop('No well-known skills found');
|
||||
warn(`No well-known skills found at ${this.source}`);
|
||||
console.log(colors.muted('You can save this URL as a skill instead:'));
|
||||
console.log(colors.muted(` skillkit save ${this.source}`));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
|
||||
if (this.provider) {
|
||||
providerAdapter = getProvider(this.provider as GitProvider);
|
||||
@@ -124,18 +143,20 @@ export class InstallCommand extends Command {
|
||||
return 1;
|
||||
}
|
||||
|
||||
s.start(`Fetching from ${providerAdapter.name}...`);
|
||||
if (!result) {
|
||||
s.start(`Fetching from ${providerAdapter.name}...`);
|
||||
result = await providerAdapter.clone(this.source, '', { depth: 1 });
|
||||
|
||||
const result = await providerAdapter.clone(this.source, '', { depth: 1 });
|
||||
if (!result.success || !result.path) {
|
||||
s.stop(colors.error(result.error || 'Failed to fetch source'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
if (!result.success || !result.path) {
|
||||
s.stop(colors.error(result.error || 'Failed to fetch source'));
|
||||
return 1;
|
||||
s.stop(`Found ${result.skills?.length || 0} skill(s)`);
|
||||
}
|
||||
|
||||
s.stop(`Found ${result.skills?.length || 0} skill(s)`);
|
||||
|
||||
const discoveredSkills = result.discoveredSkills || [];
|
||||
const cloneResult = result!;
|
||||
const discoveredSkills = cloneResult.discoveredSkills || [];
|
||||
|
||||
// List mode - just show skills and exit
|
||||
if (this.list) {
|
||||
@@ -155,7 +176,7 @@ export class InstallCommand extends Command {
|
||||
console.log(colors.muted('To install: skillkit install <source> --skill=name'));
|
||||
}
|
||||
|
||||
const cleanupPath = result.tempRoot || result.path;
|
||||
const cleanupPath = cloneResult.tempRoot || cloneResult.path;
|
||||
if (!isLocalPath(this.source) && cleanupPath && existsSync(cleanupPath)) {
|
||||
rmSync(cleanupPath, { recursive: true, force: true });
|
||||
}
|
||||
@@ -273,7 +294,7 @@ export class InstallCommand extends Command {
|
||||
console.log(formatSummary(scanResult));
|
||||
console.log(colors.muted('Use --force to install anyway, or --no-scan to skip scanning'));
|
||||
|
||||
const cleanupPath = result.tempRoot || result.path;
|
||||
const cleanupPath = cloneResult.tempRoot || cloneResult.path;
|
||||
if (!isLocalPath(this.source) && cleanupPath && existsSync(cleanupPath)) {
|
||||
rmSync(cleanupPath, { recursive: true, force: true });
|
||||
}
|
||||
@@ -343,8 +364,8 @@ export class InstallCommand extends Command {
|
||||
continue;
|
||||
}
|
||||
|
||||
const securityRoot = result.tempRoot || result.path;
|
||||
if (!isPathInside(sourcePath, securityRoot)) {
|
||||
const securityRoot = cloneResult.tempRoot || cloneResult.path || '';
|
||||
if (!securityRoot || !isPathInside(sourcePath, securityRoot)) {
|
||||
error(`Skipping ${skillName} (path traversal detected)`);
|
||||
continue;
|
||||
}
|
||||
@@ -414,11 +435,29 @@ export class InstallCommand extends Command {
|
||||
}
|
||||
|
||||
// Cleanup temp directory
|
||||
const cleanupPath = result.tempRoot || result.path;
|
||||
const cleanupPath = cloneResult.tempRoot || cloneResult.path;
|
||||
if (!isLocalPath(this.source) && cleanupPath && existsSync(cleanupPath)) {
|
||||
rmSync(cleanupPath, { recursive: true, force: true });
|
||||
}
|
||||
|
||||
if (totalInstalled > 0) {
|
||||
try {
|
||||
const agentsMdPath = join(process.cwd(), 'AGENTS.md');
|
||||
if (existsSync(agentsMdPath)) {
|
||||
const parser = new AgentsMdParser();
|
||||
const existing = readFileSync(agentsMdPath, 'utf-8');
|
||||
if (parser.hasManagedSections(existing)) {
|
||||
const gen = new AgentsMdGenerator({ projectPath: process.cwd() });
|
||||
const genResult = gen.generate();
|
||||
const updated = parser.updateManagedSections(existing, genResult.sections.filter(s => s.managed));
|
||||
writeFileSync(agentsMdPath, updated, 'utf-8');
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
warn('Failed to update AGENTS.md');
|
||||
}
|
||||
}
|
||||
|
||||
// Show summary
|
||||
if (totalInstalled > 0) {
|
||||
if (isInteractive) {
|
||||
|
||||
@@ -55,6 +55,10 @@ export class PublishCommand extends Command {
|
||||
description: 'Show what would be generated without writing files',
|
||||
});
|
||||
|
||||
format = Option.String('--format', {
|
||||
description: 'Output format: "standard" (default) or "mintlify" (.well-known/skills/default/skill.md)',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const basePath = this.skillPath || process.cwd();
|
||||
const outputDir = this.output || basePath;
|
||||
@@ -115,6 +119,44 @@ export class PublishCommand extends Command {
|
||||
|
||||
console.log('');
|
||||
|
||||
if (this.format === 'mintlify') {
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.yellow('Dry run - not writing files\n'));
|
||||
console.log(chalk.white('Would generate (Mintlify format):'));
|
||||
for (const skill of validSkills) {
|
||||
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`));
|
||||
}
|
||||
return 0;
|
||||
}
|
||||
|
||||
const resolvedOutput = resolve(outputDir);
|
||||
for (const skill of validSkills) {
|
||||
const mintlifyDir = join(outputDir, '.well-known', 'skills', skill.safeName);
|
||||
const resolvedDir = resolve(mintlifyDir);
|
||||
if (!resolvedDir.startsWith(resolvedOutput)) {
|
||||
console.log(chalk.red(`Skipping ${skill.safeName} (path traversal detected)`));
|
||||
continue;
|
||||
}
|
||||
mkdirSync(mintlifyDir, { recursive: true });
|
||||
const skillMdPath = join(skill.path, 'SKILL.md');
|
||||
if (existsSync(skillMdPath)) {
|
||||
const content = readFileSync(skillMdPath, 'utf-8');
|
||||
writeFileSync(join(mintlifyDir, 'skill.md'), content);
|
||||
}
|
||||
}
|
||||
|
||||
console.log(chalk.green('Generated Mintlify well-known structure:\n'));
|
||||
for (const skill of validSkills) {
|
||||
console.log(chalk.dim(` ${outputDir}/.well-known/skills/${skill.safeName}/skill.md`));
|
||||
}
|
||||
console.log('');
|
||||
console.log(chalk.cyan('Next steps:'));
|
||||
console.log(chalk.dim(' 1. Deploy the .well-known directory to your web server'));
|
||||
console.log(chalk.dim(' 2. Users can install via: skillkit install https://your-domain.com'));
|
||||
console.log(chalk.dim(' 3. Skills auto-discovered from /.well-known/skills/{name}/skill.md'));
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (this.dryRun) {
|
||||
console.log(chalk.yellow('Dry run - not writing files\n'));
|
||||
console.log(chalk.white('Would generate:'));
|
||||
|
||||
@@ -1,7 +1,8 @@
|
||||
import { existsSync, rmSync } from 'node:fs';
|
||||
import { existsSync, rmSync, readFileSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { findSkill } from '@skillkit/core';
|
||||
import { findSkill, AgentsMdParser, AgentsMdGenerator } from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
|
||||
export class RemoveCommand extends Command {
|
||||
@@ -52,6 +53,22 @@ export class RemoveCommand extends Command {
|
||||
}
|
||||
|
||||
if (removed > 0) {
|
||||
try {
|
||||
const agentsMdPath = join(process.cwd(), 'AGENTS.md');
|
||||
if (existsSync(agentsMdPath)) {
|
||||
const parser = new AgentsMdParser();
|
||||
const existing = readFileSync(agentsMdPath, 'utf-8');
|
||||
if (parser.hasManagedSections(existing)) {
|
||||
const gen = new AgentsMdGenerator({ projectPath: process.cwd() });
|
||||
const genResult = gen.generate();
|
||||
const updated = parser.updateManagedSections(existing, genResult.sections.filter(s => s.managed));
|
||||
writeFileSync(agentsMdPath, updated, 'utf-8');
|
||||
}
|
||||
}
|
||||
} catch (error) {
|
||||
console.log(chalk.yellow('Warning: Failed to update AGENTS.md'));
|
||||
console.error(chalk.dim(error instanceof Error ? error.message : String(error)));
|
||||
}
|
||||
console.log(chalk.dim('\nRun `skillkit sync` to update your agent config'));
|
||||
}
|
||||
|
||||
|
||||
@@ -0,0 +1,120 @@
|
||||
import { cpSync, mkdirSync } from 'node:fs';
|
||||
import { dirname, join } from 'node:path';
|
||||
import chalk from 'chalk';
|
||||
import { Command, Option } from 'clipanion';
|
||||
import { ContentExtractor, SkillGenerator, AutoTagger } from '@skillkit/core';
|
||||
import type { AgentType } from '@skillkit/core';
|
||||
import { getAdapter } from '@skillkit/agents';
|
||||
import { spinner } from '../onboarding/index.js';
|
||||
|
||||
export class SaveCommand extends Command {
|
||||
static override paths = [['save']];
|
||||
|
||||
static override usage = Command.Usage({
|
||||
description: 'Save content from a URL, text, or file as a reusable skill',
|
||||
examples: [
|
||||
['Save a webpage as a skill', '$0 save https://example.com/guide'],
|
||||
['Save with a custom name', '$0 save https://example.com/guide --name my-guide'],
|
||||
['Save raw text', '$0 save --text "Always use TypeScript strict mode"'],
|
||||
['Save a local file', '$0 save --file ./notes.md'],
|
||||
['Save globally', '$0 save https://example.com/guide --global'],
|
||||
['Save and install to agents', '$0 save https://example.com/guide --agent claude-code,cursor'],
|
||||
],
|
||||
});
|
||||
|
||||
url = Option.String({ required: false });
|
||||
|
||||
name = Option.String('--name,-n', {
|
||||
description: 'Custom skill name',
|
||||
});
|
||||
|
||||
agent = Option.String('--agent,-a', {
|
||||
description: 'Comma-separated list of agents to install the skill to',
|
||||
});
|
||||
|
||||
global = Option.Boolean('--global,-g', false, {
|
||||
description: 'Save to global skills directory',
|
||||
});
|
||||
|
||||
text = Option.String('--text,-t', {
|
||||
description: 'Raw text to save as a skill',
|
||||
});
|
||||
|
||||
file = Option.String('--file,-f', {
|
||||
description: 'Local file path to save as a skill',
|
||||
});
|
||||
|
||||
async execute(): Promise<number> {
|
||||
const sources = [this.url, this.text, this.file].filter(Boolean);
|
||||
if (sources.length === 0) {
|
||||
console.log(chalk.red('Provide a URL, --text, or --file'));
|
||||
return 1;
|
||||
}
|
||||
if (sources.length > 1) {
|
||||
console.log(chalk.red('Provide only one of: URL, --text, or --file'));
|
||||
return 1;
|
||||
}
|
||||
|
||||
const extractor = new ContentExtractor();
|
||||
const generator = new SkillGenerator();
|
||||
const tagger = new AutoTagger();
|
||||
|
||||
const s = spinner();
|
||||
|
||||
try {
|
||||
s.start('Extracting content');
|
||||
|
||||
let content;
|
||||
if (this.url) {
|
||||
content = await extractor.extractFromUrl(this.url);
|
||||
} else if (this.text) {
|
||||
content = extractor.extractFromText(this.text);
|
||||
} else {
|
||||
content = extractor.extractFromFile(this.file!);
|
||||
}
|
||||
|
||||
const tags = tagger.detectTags(content);
|
||||
content.tags = tags;
|
||||
|
||||
s.message('Generating skill');
|
||||
|
||||
const result = generator.generate(content, {
|
||||
name: this.name,
|
||||
global: this.global,
|
||||
});
|
||||
|
||||
s.stop(chalk.green('Skill saved'));
|
||||
|
||||
console.log('');
|
||||
console.log(chalk.bold(' Name: ') + chalk.cyan(result.name));
|
||||
console.log(chalk.bold(' Path: ') + chalk.dim(result.skillPath));
|
||||
if (tags.length > 0) {
|
||||
console.log(chalk.bold(' Tags: ') + tags.map(t => chalk.yellow(t)).join(', '));
|
||||
}
|
||||
|
||||
if (this.agent) {
|
||||
const agents = this.agent.split(',').map(a => a.trim()).filter(Boolean);
|
||||
const skillDir = dirname(result.skillPath);
|
||||
|
||||
for (const agentName of agents) {
|
||||
try {
|
||||
const adapter = getAdapter(agentName as AgentType);
|
||||
const targetDir = join(adapter.skillsDir, result.name);
|
||||
mkdirSync(targetDir, { recursive: true });
|
||||
cpSync(skillDir, targetDir, { recursive: true });
|
||||
console.log(chalk.green(` Installed to ${agentName}: `) + chalk.dim(targetDir));
|
||||
} catch (err) {
|
||||
console.log(chalk.yellow(` Skipped ${agentName}: ${err instanceof Error ? err.message : String(err)}`));
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
return 0;
|
||||
} catch (err) {
|
||||
s.stop(chalk.red('Failed'));
|
||||
console.log(chalk.red(err instanceof Error ? err.message : String(err)));
|
||||
return 1;
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -9,8 +9,10 @@ import {
|
||||
isHighQuality,
|
||||
findAllSkills,
|
||||
benchmarkSkill,
|
||||
SpecValidator,
|
||||
type QualityScore,
|
||||
type BenchmarkResult,
|
||||
type SpecValidationResult,
|
||||
} from '@skillkit/core';
|
||||
import { getSearchDirs } from '../helpers.js';
|
||||
import {
|
||||
@@ -142,6 +144,22 @@ function printBenchmarkReport(benchmark: BenchmarkResult): void {
|
||||
}
|
||||
}
|
||||
|
||||
function printSpecReport(specResult: SpecValidationResult): void {
|
||||
console.log('');
|
||||
console.log(colors.bold('Spec Validation'));
|
||||
console.log(` ${colors.muted('Spec Version:')} ${specResult.specVersion}`);
|
||||
console.log(` ${colors.muted('Valid:')} ${specResult.valid ? colors.success('yes') : colors.error('no')}`);
|
||||
|
||||
if (specResult.checks.length > 0) {
|
||||
console.log('');
|
||||
for (const check of specResult.checks) {
|
||||
const icon = check.passed ? colors.success(symbols.success) : (check.severity === 'error' ? colors.error(symbols.error) : colors.warning(symbols.warning));
|
||||
console.log(` ${icon} ${check.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
function getOrdinal(n: number): string {
|
||||
const s = ['th', 'st', 'nd', 'rd'];
|
||||
const v = n % 100;
|
||||
@@ -198,6 +216,10 @@ export class ValidateCommand extends Command {
|
||||
description: 'Compare skill against category leaders',
|
||||
});
|
||||
|
||||
strict = Option.Boolean('--strict,-s', false, {
|
||||
description: 'Run strict spec validation checks',
|
||||
});
|
||||
|
||||
fix = Option.Boolean('--fix', false, {
|
||||
description: 'Automatically fix common quality issues (runs fix command)',
|
||||
});
|
||||
@@ -378,7 +400,7 @@ export class ValidateCommand extends Command {
|
||||
|
||||
filteredResults.sort((a, b) => (b.quality?.overall ?? 0) - (a.quality?.overall ?? 0));
|
||||
|
||||
for (const { name, quality, formatValid, formatErrors } of filteredResults) {
|
||||
for (const { name, quality, formatValid, formatErrors, path: skillPath } of filteredResults) {
|
||||
if (!formatValid) {
|
||||
console.log(`\n${colors.error(symbols.error)} ${colors.primary(name)}`);
|
||||
console.log(` ${colors.error('Format validation failed:')}`);
|
||||
@@ -395,6 +417,12 @@ export class ValidateCommand extends Command {
|
||||
printBenchmarkReport(benchmark);
|
||||
}
|
||||
}
|
||||
|
||||
if (this.strict && skillPath) {
|
||||
const specValidator = new SpecValidator();
|
||||
const specResult = specValidator.validate(skillPath, { strict: true });
|
||||
printSpecReport(specResult);
|
||||
}
|
||||
}
|
||||
|
||||
console.log('');
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/core",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Core functionality for SkillKit - skill discovery, parsing, and translation",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -53,22 +53,25 @@
|
||||
"test": "vitest run"
|
||||
},
|
||||
"dependencies": {
|
||||
"@mozilla/readability": "^0.6.0",
|
||||
"minimatch": "^10.1.1",
|
||||
"turndown": "^7.2.2",
|
||||
"yaml": "^2.6.1",
|
||||
"zod": "^3.24.1"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@anthropic-ai/sdk": "^0.39.0",
|
||||
"openai": "^4.0.0",
|
||||
"@google/genai": "^1.0.0",
|
||||
"ollama": "^0.5.0",
|
||||
"node-llama-cpp": "^3.15.0",
|
||||
"better-sqlite3": "^12.0.0",
|
||||
"node-llama-cpp": "^3.15.0",
|
||||
"ollama": "^0.5.0",
|
||||
"openai": "^4.0.0",
|
||||
"sqlite-vec": "^0.1.6"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/better-sqlite3": "^7.6.11",
|
||||
"@types/node": "^22.10.5",
|
||||
"@types/turndown": "^5.0.6",
|
||||
"tsup": "^8.3.5",
|
||||
"typescript": "^5.7.2",
|
||||
"vitest": "^2.1.8"
|
||||
|
||||
@@ -0,0 +1,206 @@
|
||||
import { existsSync, readFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { ProjectDetector } from '../context/detector.js';
|
||||
import { findAllSkills } from '../skills.js';
|
||||
import type { Skill } from '../types.js';
|
||||
import type { AgentsMdConfig, AgentsMdResult, AgentsMdSection } from './types.js';
|
||||
|
||||
function escapeTableCell(text: string): string {
|
||||
return text.replace(/\|/g, '\\|').replace(/\n/g, ' ');
|
||||
}
|
||||
|
||||
const MANAGED_START = '<!-- skillkit:managed:start -->';
|
||||
const MANAGED_END = '<!-- skillkit:managed:end -->';
|
||||
|
||||
export class AgentsMdGenerator {
|
||||
private config: AgentsMdConfig;
|
||||
private detector: ProjectDetector;
|
||||
|
||||
constructor(config: AgentsMdConfig) {
|
||||
this.config = config;
|
||||
this.detector = new ProjectDetector(config.projectPath);
|
||||
}
|
||||
|
||||
generate(): AgentsMdResult {
|
||||
this.detector.analyze();
|
||||
|
||||
const sections: AgentsMdSection[] = [];
|
||||
|
||||
sections.push({
|
||||
id: 'project-overview',
|
||||
title: 'Project Overview',
|
||||
content: this.generateProjectSection(),
|
||||
managed: true,
|
||||
});
|
||||
|
||||
sections.push({
|
||||
id: 'technology-stack',
|
||||
title: 'Technology Stack',
|
||||
content: this.generateStackSection(),
|
||||
managed: true,
|
||||
});
|
||||
|
||||
if (this.config.includeSkills !== false) {
|
||||
const skillsContent = this.generateSkillsSection(findAllSkills([join(this.config.projectPath, 'skills')]));
|
||||
if (skillsContent) {
|
||||
sections.push({
|
||||
id: 'installed-skills',
|
||||
title: 'Installed Skills',
|
||||
content: skillsContent,
|
||||
managed: true,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
if (this.config.includeBuildCommands !== false) {
|
||||
const buildContent = this.generateBuildSection();
|
||||
if (buildContent) {
|
||||
sections.push({
|
||||
id: 'build-test',
|
||||
title: 'Build & Test',
|
||||
content: buildContent,
|
||||
managed: true,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
if (this.config.includeCodeStyle !== false) {
|
||||
const styleContent = this.generateCodeStyleSection();
|
||||
if (styleContent) {
|
||||
sections.push({
|
||||
id: 'code-style',
|
||||
title: 'Code Style',
|
||||
content: styleContent,
|
||||
managed: true,
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
const lines: string[] = ['# AGENTS.md', '', MANAGED_START];
|
||||
for (const section of sections) {
|
||||
lines.push(`## ${section.title}`);
|
||||
lines.push(section.content);
|
||||
lines.push('');
|
||||
}
|
||||
lines.push(MANAGED_END, '');
|
||||
|
||||
const content = lines.join('\n');
|
||||
return {
|
||||
content,
|
||||
sections,
|
||||
path: join(this.config.projectPath, 'AGENTS.md'),
|
||||
};
|
||||
}
|
||||
|
||||
generateSkillsSection(skills: Skill[]): string {
|
||||
if (skills.length === 0) {
|
||||
return '';
|
||||
}
|
||||
|
||||
const lines: string[] = [
|
||||
'| Skill | Description | Tags |',
|
||||
'|-------|-------------|------|',
|
||||
];
|
||||
|
||||
for (const skill of skills) {
|
||||
const name = escapeTableCell(skill.name);
|
||||
const desc = escapeTableCell(skill.description);
|
||||
lines.push(`| ${name} | ${desc} | |`);
|
||||
}
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
generateProjectSection(): string {
|
||||
const name = this.detector.getProjectName();
|
||||
const description = this.detector.getProjectDescription();
|
||||
const projectType = this.detector.detectProjectType();
|
||||
|
||||
const lines: string[] = [];
|
||||
lines.push(`- **Name**: ${name}`);
|
||||
if (description) {
|
||||
lines.push(`- **Description**: ${description}`);
|
||||
}
|
||||
lines.push(`- **Type**: ${projectType}`);
|
||||
|
||||
return lines.join('\n');
|
||||
}
|
||||
|
||||
generateBuildSection(): string {
|
||||
const packageJsonPath = join(this.config.projectPath, 'package.json');
|
||||
if (!existsSync(packageJsonPath)) {
|
||||
return '';
|
||||
}
|
||||
|
||||
try {
|
||||
const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
|
||||
const scripts = pkg.scripts as Record<string, string> | undefined;
|
||||
if (!scripts || Object.keys(scripts).length === 0) {
|
||||
return '';
|
||||
}
|
||||
|
||||
const relevantScripts = ['build', 'dev', 'start', 'test', 'lint', 'format', 'typecheck', 'check'];
|
||||
const lines: string[] = ['```bash'];
|
||||
|
||||
for (const key of relevantScripts) {
|
||||
if (scripts[key]) {
|
||||
lines.push(`# ${key}`);
|
||||
lines.push(scripts[key]);
|
||||
lines.push('');
|
||||
}
|
||||
}
|
||||
|
||||
if (lines.length === 1) {
|
||||
return '';
|
||||
}
|
||||
|
||||
lines.push('```');
|
||||
return lines.join('\n');
|
||||
} catch {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
generateCodeStyleSection(): string {
|
||||
const patterns = this.detector.detectPatterns();
|
||||
const lines: string[] = [];
|
||||
|
||||
if (patterns.linting) {
|
||||
lines.push(`- **Linting**: ${patterns.linting}`);
|
||||
}
|
||||
if (patterns.formatting) {
|
||||
lines.push(`- **Formatting**: ${patterns.formatting}`);
|
||||
}
|
||||
if (patterns.testing) {
|
||||
lines.push(`- **Testing**: ${patterns.testing}`);
|
||||
}
|
||||
if (patterns.styling) {
|
||||
lines.push(`- **Styling**: ${patterns.styling}`);
|
||||
}
|
||||
|
||||
return lines.length > 0 ? lines.join('\n') : '';
|
||||
}
|
||||
|
||||
private generateStackSection(): string {
|
||||
const stack = this.detector.analyze();
|
||||
const lines: string[] = [];
|
||||
|
||||
if (stack.languages.length > 0) {
|
||||
lines.push(`- **Languages**: ${stack.languages.map(l => l.version ? `${l.name} ${l.version}` : l.name).join(', ')}`);
|
||||
}
|
||||
if (stack.frameworks.length > 0) {
|
||||
lines.push(`- **Frameworks**: ${stack.frameworks.map(f => f.version ? `${f.name} ${f.version}` : f.name).join(', ')}`);
|
||||
}
|
||||
if (stack.libraries.length > 0) {
|
||||
lines.push(`- **Libraries**: ${stack.libraries.map(l => l.name).join(', ')}`);
|
||||
}
|
||||
if (stack.databases.length > 0) {
|
||||
lines.push(`- **Databases**: ${stack.databases.map(d => d.name).join(', ')}`);
|
||||
}
|
||||
if (stack.runtime.length > 0) {
|
||||
lines.push(`- **Runtime**: ${stack.runtime.map(r => r.version ? `${r.name} ${r.version}` : r.name).join(', ')}`);
|
||||
}
|
||||
|
||||
return lines.length > 0 ? lines.join('\n') : 'No technology stack detected.';
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,3 @@
|
||||
export { AgentsMdGenerator } from './generator.js';
|
||||
export { AgentsMdParser } from './parser.js';
|
||||
export type { AgentsMdConfig, AgentsMdSection, AgentsMdResult } from './types.js';
|
||||
@@ -0,0 +1,103 @@
|
||||
import type { AgentsMdSection } from './types.js';
|
||||
|
||||
const MANAGED_START = '<!-- skillkit:managed:start -->';
|
||||
const MANAGED_END = '<!-- skillkit:managed:end -->';
|
||||
|
||||
export class AgentsMdParser {
|
||||
parse(content: string): AgentsMdSection[] {
|
||||
const sections: AgentsMdSection[] = [];
|
||||
const lines = content.split('\n');
|
||||
|
||||
let inManaged = false;
|
||||
let currentSection: { id: string; title: string; lines: string[]; managed: boolean } | null = null;
|
||||
|
||||
for (const line of lines) {
|
||||
if (line.trim() === MANAGED_START) {
|
||||
inManaged = true;
|
||||
continue;
|
||||
}
|
||||
|
||||
if (line.trim() === MANAGED_END) {
|
||||
if (currentSection) {
|
||||
sections.push({
|
||||
id: currentSection.id,
|
||||
title: currentSection.title,
|
||||
content: currentSection.lines.join('\n').trim(),
|
||||
managed: currentSection.managed,
|
||||
});
|
||||
currentSection = null;
|
||||
}
|
||||
inManaged = false;
|
||||
continue;
|
||||
}
|
||||
|
||||
const headingMatch = line.match(/^##\s+(.+)$/);
|
||||
if (headingMatch) {
|
||||
if (currentSection) {
|
||||
sections.push({
|
||||
id: currentSection.id,
|
||||
title: currentSection.title,
|
||||
content: currentSection.lines.join('\n').trim(),
|
||||
managed: currentSection.managed,
|
||||
});
|
||||
}
|
||||
const title = headingMatch[1];
|
||||
currentSection = {
|
||||
id: title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, ''),
|
||||
title,
|
||||
lines: [],
|
||||
managed: inManaged,
|
||||
};
|
||||
continue;
|
||||
}
|
||||
|
||||
if (currentSection) {
|
||||
currentSection.lines.push(line);
|
||||
}
|
||||
}
|
||||
|
||||
if (currentSection) {
|
||||
sections.push({
|
||||
id: currentSection.id,
|
||||
title: currentSection.title,
|
||||
content: currentSection.lines.join('\n').trim(),
|
||||
managed: currentSection.managed,
|
||||
});
|
||||
}
|
||||
|
||||
return sections;
|
||||
}
|
||||
|
||||
hasManagedSections(content: string): boolean {
|
||||
return content.includes(MANAGED_START) && content.includes(MANAGED_END);
|
||||
}
|
||||
|
||||
updateManagedSections(existing: string, newManaged: AgentsMdSection[]): string {
|
||||
if (!this.hasManagedSections(existing)) {
|
||||
return existing;
|
||||
}
|
||||
|
||||
const startIdx = existing.indexOf(MANAGED_START);
|
||||
const endIdx = existing.indexOf(MANAGED_END);
|
||||
if (startIdx >= endIdx) {
|
||||
return existing;
|
||||
}
|
||||
|
||||
const managedBlock = this.buildManagedBlock(newManaged);
|
||||
const before = existing.substring(0, startIdx);
|
||||
const after = existing.substring(endIdx + MANAGED_END.length);
|
||||
|
||||
return `${before}${managedBlock}${after}`;
|
||||
}
|
||||
|
||||
private buildManagedBlock(sections: AgentsMdSection[]): string {
|
||||
const lines: string[] = [MANAGED_START];
|
||||
for (const section of sections) {
|
||||
lines.push(`## ${section.title}`);
|
||||
lines.push(section.content);
|
||||
lines.push('');
|
||||
}
|
||||
lines.push(MANAGED_END);
|
||||
return lines.join('\n');
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,19 @@
|
||||
export interface AgentsMdConfig {
|
||||
projectPath: string;
|
||||
includeSkills?: boolean;
|
||||
includeBuildCommands?: boolean;
|
||||
includeCodeStyle?: boolean;
|
||||
}
|
||||
|
||||
export interface AgentsMdSection {
|
||||
id: string;
|
||||
title: string;
|
||||
content: string;
|
||||
managed: boolean;
|
||||
}
|
||||
|
||||
export interface AgentsMdResult {
|
||||
content: string;
|
||||
sections: AgentsMdSection[];
|
||||
path: string;
|
||||
}
|
||||
@@ -123,3 +123,12 @@ export * from './runtime/index.js';
|
||||
|
||||
// Security Scanner
|
||||
export * from './scanner/index.js';
|
||||
|
||||
// Spec Validation
|
||||
export * from './validation/index.js';
|
||||
|
||||
// AGENTS.md generator
|
||||
export * from './agents-md/index.js';
|
||||
|
||||
// Save (Content Extraction & Skill Generation)
|
||||
export * from './save/index.js';
|
||||
|
||||
@@ -6,6 +6,18 @@ import type { GitProviderAdapter, CloneOptions } from './base.js';
|
||||
import { isGitUrl, isLocalPath } from './base.js';
|
||||
import type { GitProvider, CloneResult } from '../types.js';
|
||||
|
||||
function skillNameFromUrl(url: string): string {
|
||||
try {
|
||||
const parsed = new URL(url);
|
||||
const segments = parsed.pathname.split('/').filter(Boolean);
|
||||
return segments[segments.length - 1] || parsed.hostname.split('.')[0] || 'default';
|
||||
} catch {
|
||||
return basename(url) || 'default';
|
||||
}
|
||||
}
|
||||
|
||||
const FRONTMATTER_REGEX = /^---\s*\n[\s\S]*?name:\s*.+/;
|
||||
|
||||
function sanitizeSkillName(name: string): string | null {
|
||||
if (!name || typeof name !== 'string') return null;
|
||||
const base = basename(name);
|
||||
@@ -29,6 +41,12 @@ export interface WellKnownIndex {
|
||||
skills: WellKnownSkill[];
|
||||
}
|
||||
|
||||
const MINTLIFY_PATHS = [
|
||||
'/.well-known/skills/default/skill.md',
|
||||
'/skill.md',
|
||||
'/.well-known/skill.md',
|
||||
];
|
||||
|
||||
export class WellKnownProvider implements GitProviderAdapter {
|
||||
readonly type: GitProvider = 'wellknown';
|
||||
readonly name = 'Well-Known';
|
||||
@@ -66,6 +84,57 @@ export class WellKnownProvider implements GitProviderAdapter {
|
||||
return '';
|
||||
}
|
||||
|
||||
async discoverFromUrl(url: string): Promise<CloneResult> {
|
||||
const baseUrl = url.replace(/\/$/, '');
|
||||
const tempDir = join(tmpdir(), `skillkit-wellknown-${randomUUID()}`);
|
||||
|
||||
try {
|
||||
mkdirSync(tempDir, { recursive: true });
|
||||
|
||||
for (const mintlifyPath of MINTLIFY_PATHS) {
|
||||
const fullUrl = `${baseUrl}${mintlifyPath}`;
|
||||
try {
|
||||
const response = await fetch(fullUrl);
|
||||
if (response.ok) {
|
||||
const content = await response.text();
|
||||
if (FRONTMATTER_REGEX.test(content)) {
|
||||
const skillName = skillNameFromUrl(baseUrl);
|
||||
const safeName = sanitizeSkillName(skillName) ?? 'default';
|
||||
const skillDir = join(tempDir, safeName);
|
||||
mkdirSync(skillDir, { recursive: true });
|
||||
writeFileSync(join(skillDir, 'SKILL.md'), content);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
path: tempDir,
|
||||
tempRoot: tempDir,
|
||||
skills: [safeName],
|
||||
discoveredSkills: [{ name: safeName, dirName: safeName, path: skillDir }],
|
||||
};
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
const indexResult = await this.clone(baseUrl, '', {});
|
||||
if (indexResult.success) {
|
||||
rmSync(tempDir, { recursive: true, force: true });
|
||||
return indexResult;
|
||||
}
|
||||
|
||||
rmSync(tempDir, { recursive: true, force: true });
|
||||
return { success: false, error: 'No well-known skills found' };
|
||||
} catch (error) {
|
||||
if (existsSync(tempDir)) {
|
||||
rmSync(tempDir, { recursive: true, force: true });
|
||||
}
|
||||
const message = error instanceof Error ? error.message : String(error);
|
||||
return { success: false, error: `Failed to discover skills: ${message}` };
|
||||
}
|
||||
}
|
||||
|
||||
async clone(source: string, _targetDir: string, _options: CloneOptions = {}): Promise<CloneResult> {
|
||||
const tempDir = join(tmpdir(), `skillkit-wellknown-${randomUUID()}`);
|
||||
|
||||
@@ -95,6 +164,34 @@ export class WellKnownProvider implements GitProviderAdapter {
|
||||
}
|
||||
|
||||
if (!index || !index.skills || index.skills.length === 0) {
|
||||
for (const mintlifyPath of MINTLIFY_PATHS) {
|
||||
const fullUrl = `${baseUrl}${mintlifyPath}`;
|
||||
try {
|
||||
const response = await fetch(fullUrl);
|
||||
if (response.ok) {
|
||||
const content = await response.text();
|
||||
if (FRONTMATTER_REGEX.test(content)) {
|
||||
const skillName = skillNameFromUrl(baseUrl);
|
||||
const safeName = sanitizeSkillName(skillName) ?? 'default';
|
||||
const skillDir = join(tempDir, safeName);
|
||||
mkdirSync(skillDir, { recursive: true });
|
||||
writeFileSync(join(skillDir, 'SKILL.md'), content);
|
||||
|
||||
return {
|
||||
success: true,
|
||||
path: tempDir,
|
||||
tempRoot: tempDir,
|
||||
skills: [safeName],
|
||||
discoveredSkills: [{ name: safeName, dirName: safeName, path: skillDir }],
|
||||
};
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
continue;
|
||||
}
|
||||
}
|
||||
|
||||
rmSync(tempDir, { recursive: true, force: true });
|
||||
return {
|
||||
success: false,
|
||||
error: `No skills found at ${baseUrl}/.well-known/skills/index.json`,
|
||||
|
||||
@@ -559,10 +559,39 @@ export function evaluateSkillFile(filePath: string): QualityScore | null {
|
||||
}
|
||||
}
|
||||
|
||||
function checkNameDirectoryMatch(content: string, dirPath: string): string | null {
|
||||
const frontmatter = extractFrontmatter(content);
|
||||
if (!frontmatter || typeof frontmatter.name !== 'string') return null;
|
||||
const dirName = basename(dirPath);
|
||||
if (frontmatter.name !== dirName) {
|
||||
return `Skill name "${frontmatter.name}" does not match directory "${dirName}"`;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
function checkTokenBudget(content: string): string | null {
|
||||
const normalizedContent = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
|
||||
const fmMatch = normalizedContent.match(/^---\s*\n[\s\S]*?\n---\s*\n?/);
|
||||
const body = fmMatch ? normalizedContent.slice(fmMatch[0].length) : normalizedContent;
|
||||
const bodyLines = body.split('\n').length;
|
||||
if (bodyLines > 500) {
|
||||
return `Body is ${bodyLines} lines (exceeds 500). Consider moving content to references/ directory`;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function evaluateSkillDirectory(dirPath: string): QualityScore | null {
|
||||
const skillMdPath = join(dirPath, 'SKILL.md');
|
||||
if (existsSync(skillMdPath)) {
|
||||
return evaluateSkillFile(skillMdPath);
|
||||
const result = evaluateSkillFile(skillMdPath);
|
||||
if (result) {
|
||||
const content = readFileSync(skillMdPath, 'utf-8');
|
||||
const nameWarning = checkNameDirectoryMatch(content, dirPath);
|
||||
if (nameWarning) result.warnings.push(nameWarning);
|
||||
const budgetWarning = checkTokenBudget(content);
|
||||
if (budgetWarning) result.warnings.push(budgetWarning);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
const mdcFiles = ['index.mdc', `${basename(dirPath)}.mdc`];
|
||||
|
||||
@@ -0,0 +1,196 @@
|
||||
import { existsSync, readFileSync } from 'node:fs';
|
||||
import { basename, extname } from 'node:path';
|
||||
import TurndownService from 'turndown';
|
||||
import type { ExtractedContent, ExtractionOptions } from './types.js';
|
||||
|
||||
const LANGUAGE_MAP: Record<string, string> = {
|
||||
'.ts': 'typescript',
|
||||
'.tsx': 'typescript',
|
||||
'.js': 'javascript',
|
||||
'.jsx': 'javascript',
|
||||
'.py': 'python',
|
||||
'.rb': 'ruby',
|
||||
'.go': 'go',
|
||||
'.rs': 'rust',
|
||||
'.java': 'java',
|
||||
'.kt': 'kotlin',
|
||||
'.swift': 'swift',
|
||||
'.c': 'c',
|
||||
'.cpp': 'cpp',
|
||||
'.cs': 'csharp',
|
||||
'.php': 'php',
|
||||
'.sh': 'shell',
|
||||
'.bash': 'shell',
|
||||
'.zsh': 'shell',
|
||||
'.yml': 'yaml',
|
||||
'.yaml': 'yaml',
|
||||
'.json': 'json',
|
||||
'.toml': 'toml',
|
||||
'.md': 'markdown',
|
||||
'.mdx': 'markdown',
|
||||
'.html': 'html',
|
||||
'.css': 'css',
|
||||
'.scss': 'scss',
|
||||
'.sql': 'sql',
|
||||
'.r': 'r',
|
||||
'.lua': 'lua',
|
||||
'.dart': 'dart',
|
||||
'.ex': 'elixir',
|
||||
'.exs': 'elixir',
|
||||
'.zig': 'zig',
|
||||
'.nim': 'nim',
|
||||
'.vue': 'vue',
|
||||
'.svelte': 'svelte',
|
||||
};
|
||||
|
||||
const GITHUB_URL_PATTERN = /^https?:\/\/github\.com\/([^/]+)\/([^/]+)\/blob\/([^/]+)\/(.+)$/;
|
||||
const GITHUB_RAW_PATTERN = /^https?:\/\/raw\.githubusercontent\.com\//;
|
||||
const FETCH_TIMEOUT = 30_000;
|
||||
|
||||
export class ContentExtractor {
|
||||
private turndown: TurndownService;
|
||||
|
||||
constructor() {
|
||||
this.turndown = new TurndownService({
|
||||
headingStyle: 'atx',
|
||||
codeBlockStyle: 'fenced',
|
||||
});
|
||||
}
|
||||
|
||||
async extractFromUrl(url: string, options?: ExtractionOptions): Promise<ExtractedContent> {
|
||||
if (this.isGitHubUrl(url)) {
|
||||
return this.fetchGitHubContent(url, options);
|
||||
}
|
||||
|
||||
const response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
|
||||
if (!response.ok) {
|
||||
throw new Error(`Failed to fetch ${url}: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
const contentType = response.headers.get('content-type') ?? '';
|
||||
const body = await response.text();
|
||||
|
||||
if (contentType.includes('text/html')) {
|
||||
const { title, content } = this.htmlToMarkdown(body, url);
|
||||
const finalContent = options?.maxLength ? content.slice(0, options.maxLength) : content;
|
||||
|
||||
return {
|
||||
title: options?.preferredTitle ?? title,
|
||||
content: finalContent,
|
||||
sourceUrl: url,
|
||||
tags: [],
|
||||
extractedAt: new Date().toISOString(),
|
||||
contentType: 'webpage',
|
||||
metadata: { url },
|
||||
};
|
||||
}
|
||||
|
||||
const title = options?.preferredTitle ?? new URL(url).pathname.split('/').pop() ?? 'Untitled';
|
||||
const finalContent = options?.maxLength ? body.slice(0, options.maxLength) : body;
|
||||
|
||||
return {
|
||||
title,
|
||||
content: finalContent,
|
||||
sourceUrl: url,
|
||||
tags: [],
|
||||
extractedAt: new Date().toISOString(),
|
||||
contentType: 'text',
|
||||
metadata: { url },
|
||||
};
|
||||
}
|
||||
|
||||
extractFromText(text: string, options?: ExtractionOptions): ExtractedContent {
|
||||
const firstLine = text.split('\n')[0]?.trim() ?? '';
|
||||
const title = options?.preferredTitle ?? (firstLine.length > 0 && firstLine.length <= 100 ? firstLine : 'Untitled');
|
||||
const content = options?.maxLength ? text.slice(0, options.maxLength) : text;
|
||||
|
||||
return {
|
||||
title,
|
||||
content,
|
||||
tags: [],
|
||||
extractedAt: new Date().toISOString(),
|
||||
contentType: 'text',
|
||||
metadata: {},
|
||||
};
|
||||
}
|
||||
|
||||
extractFromFile(filePath: string, options?: ExtractionOptions): ExtractedContent {
|
||||
if (!existsSync(filePath)) {
|
||||
throw new Error(`File not found: ${filePath}`);
|
||||
}
|
||||
|
||||
const raw = readFileSync(filePath, 'utf-8');
|
||||
const name = basename(filePath);
|
||||
const language = this.detectLanguage(name);
|
||||
const isCode = language !== undefined && language !== 'markdown';
|
||||
const title = options?.preferredTitle ?? name;
|
||||
const content = options?.maxLength ? raw.slice(0, options.maxLength) : raw;
|
||||
|
||||
return {
|
||||
title,
|
||||
content: isCode ? `\`\`\`${language}\n${content}\n\`\`\`` : content,
|
||||
sourcePath: filePath,
|
||||
tags: language ? [language] : [],
|
||||
extractedAt: new Date().toISOString(),
|
||||
contentType: isCode ? 'code' : 'file',
|
||||
language,
|
||||
metadata: { filename: name },
|
||||
};
|
||||
}
|
||||
|
||||
private isGitHubUrl(url: string): boolean {
|
||||
return GITHUB_URL_PATTERN.test(url) || GITHUB_RAW_PATTERN.test(url);
|
||||
}
|
||||
|
||||
private async fetchGitHubContent(url: string, options?: ExtractionOptions): Promise<ExtractedContent> {
|
||||
let rawUrl = url;
|
||||
const match = url.match(GITHUB_URL_PATTERN);
|
||||
if (match) {
|
||||
const [, owner, repo, branch, path] = match;
|
||||
rawUrl = `https://raw.githubusercontent.com/${owner}/${repo}/${branch}/${path}`;
|
||||
}
|
||||
|
||||
const response = await fetch(rawUrl, { signal: AbortSignal.timeout(FETCH_TIMEOUT) });
|
||||
if (!response.ok) {
|
||||
throw new Error(`Failed to fetch GitHub content: ${response.status} ${response.statusText}`);
|
||||
}
|
||||
|
||||
const body = await response.text();
|
||||
const filename = rawUrl.split('/').pop() ?? 'file';
|
||||
const language = this.detectLanguage(filename);
|
||||
const isCode = language !== undefined && language !== 'markdown';
|
||||
const title = options?.preferredTitle ?? filename;
|
||||
const content = options?.maxLength ? body.slice(0, options.maxLength) : body;
|
||||
|
||||
return {
|
||||
title,
|
||||
content: isCode ? `\`\`\`${language}\n${content}\n\`\`\`` : content,
|
||||
sourceUrl: url,
|
||||
tags: language ? ['github', language] : ['github'],
|
||||
extractedAt: new Date().toISOString(),
|
||||
contentType: 'github',
|
||||
language,
|
||||
metadata: {
|
||||
url,
|
||||
rawUrl,
|
||||
filename,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
private htmlToMarkdown(html: string, url: string): { title: string; content: string } {
|
||||
const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
|
||||
const title = titleMatch?.[1]?.trim() ?? new URL(url).hostname;
|
||||
|
||||
const bodyMatch = html.match(/<body[^>]*>([\s\S]*)<\/body>/i);
|
||||
const bodyHtml = bodyMatch?.[1] ?? html;
|
||||
|
||||
const content = this.turndown.turndown(bodyHtml);
|
||||
return { title, content };
|
||||
}
|
||||
|
||||
private detectLanguage(filename: string): string | undefined {
|
||||
const ext = extname(filename).toLowerCase();
|
||||
return LANGUAGE_MAP[ext];
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,5 @@
|
||||
export { ContentExtractor } from './extractor.js';
|
||||
export { AutoTagger } from './tagger.js';
|
||||
export { SkillGenerator } from './skill-generator.js';
|
||||
export type { ExtractedContent, ExtractionOptions } from './types.js';
|
||||
export type { SaveGenerateOptions, SaveGeneratedSkill } from './skill-generator.js';
|
||||
@@ -0,0 +1,121 @@
|
||||
import { mkdirSync, writeFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { homedir } from 'node:os';
|
||||
import type { ExtractedContent } from './types.js';
|
||||
import { AutoTagger } from './tagger.js';
|
||||
|
||||
export interface SaveGenerateOptions {
|
||||
name?: string;
|
||||
global?: boolean;
|
||||
outputDir?: string;
|
||||
}
|
||||
|
||||
export interface SaveGeneratedSkill {
|
||||
skillPath: string;
|
||||
skillMd: string;
|
||||
name: string;
|
||||
}
|
||||
|
||||
const MAX_NAME_LENGTH = 64;
|
||||
const SUMMARY_LINE_LIMIT = 100;
|
||||
const SPLIT_THRESHOLD = 500;
|
||||
const DESCRIPTION_MAX = 200;
|
||||
|
||||
export class SkillGenerator {
|
||||
private tagger = new AutoTagger();
|
||||
|
||||
generate(content: ExtractedContent, options: SaveGenerateOptions = {}): SaveGeneratedSkill {
|
||||
const name = options.name
|
||||
? this.slugify(options.name)
|
||||
: this.slugify(content.title || 'untitled-skill');
|
||||
|
||||
const tags = this.tagger.detectTags(content);
|
||||
const description = this.makeDescription(content.content);
|
||||
const source = content.sourceUrl ?? content.sourcePath ?? '';
|
||||
|
||||
const frontmatter = this.buildFrontmatter(name, description, tags, source);
|
||||
const lines = content.content.split('\n');
|
||||
const needsSplit = lines.length > SPLIT_THRESHOLD;
|
||||
|
||||
const body = needsSplit
|
||||
? lines.slice(0, SUMMARY_LINE_LIMIT).join('\n')
|
||||
: content.content;
|
||||
|
||||
const skillMd = `${frontmatter}\n${body}\n`;
|
||||
|
||||
const outputDir = options.outputDir ?? this.defaultOutputDir(name, options.global);
|
||||
mkdirSync(outputDir, { recursive: true });
|
||||
|
||||
const skillPath = join(outputDir, 'SKILL.md');
|
||||
writeFileSync(skillPath, skillMd, 'utf-8');
|
||||
|
||||
if (needsSplit) {
|
||||
const refsDir = join(outputDir, 'references');
|
||||
mkdirSync(refsDir, { recursive: true });
|
||||
writeFileSync(
|
||||
join(refsDir, 'full-content.md'),
|
||||
content.content,
|
||||
'utf-8',
|
||||
);
|
||||
}
|
||||
|
||||
return { skillPath, skillMd, name };
|
||||
}
|
||||
|
||||
private slugify(input: string): string {
|
||||
const slug = input
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, '-')
|
||||
.replace(/^-+|-+$/g, '')
|
||||
.replace(/-{2,}/g, '-');
|
||||
|
||||
const trimmed = slug.slice(0, MAX_NAME_LENGTH).replace(/-+$/, '');
|
||||
return trimmed || 'untitled-skill';
|
||||
}
|
||||
|
||||
private makeDescription(content: string): string {
|
||||
const firstLine = content.split('\n').find((l) => l.trim().length > 0) ?? '';
|
||||
const cleaned = firstLine.replace(/^#+\s*/, '').trim();
|
||||
return cleaned.length > DESCRIPTION_MAX
|
||||
? cleaned.slice(0, DESCRIPTION_MAX - 3) + '...'
|
||||
: cleaned || 'Saved skill';
|
||||
}
|
||||
|
||||
private buildFrontmatter(
|
||||
name: string,
|
||||
description: string,
|
||||
tags: string[],
|
||||
source: string,
|
||||
): string {
|
||||
const yamlTags = tags.map((t) => ` - ${t}`).join('\n');
|
||||
const savedAt = new Date().toISOString();
|
||||
|
||||
const lines = [
|
||||
'---',
|
||||
`name: ${name}`,
|
||||
`description: ${this.yamlEscape(description)}`,
|
||||
tags.length > 0 ? `tags:\n${yamlTags}` : null,
|
||||
'metadata:',
|
||||
source ? ` source: ${source}` : null,
|
||||
` savedAt: ${savedAt}`,
|
||||
'---',
|
||||
].filter((l): l is string => l !== null);
|
||||
|
||||
return lines.join('\n') + '\n';
|
||||
}
|
||||
|
||||
private yamlEscape(value: string): string {
|
||||
const singleLine = value.replace(/\r?\n/g, ' ').trim();
|
||||
if (/[:#{}[\],&*?|>!%@`]/.test(singleLine) || singleLine.startsWith("'") || singleLine.startsWith('"')) {
|
||||
return `"${singleLine.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
|
||||
}
|
||||
return singleLine;
|
||||
}
|
||||
|
||||
private defaultOutputDir(name: string, global?: boolean): string {
|
||||
if (global) {
|
||||
return join(homedir(), '.skillkit', 'skills', name);
|
||||
}
|
||||
return join('.skillkit', 'skills', name);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,98 @@
|
||||
import type { ExtractedContent } from './types.js';
|
||||
|
||||
const TECH_KEYWORDS = new Set([
|
||||
'react', 'vue', 'angular', 'svelte', 'nextjs', 'nuxt', 'remix',
|
||||
'typescript', 'javascript', 'python', 'rust', 'go', 'java', 'ruby',
|
||||
'node', 'deno', 'bun', 'docker', 'kubernetes', 'terraform',
|
||||
'aws', 'gcp', 'azure', 'vercel', 'netlify', 'cloudflare',
|
||||
'graphql', 'rest', 'grpc', 'websocket', 'redis', 'postgres',
|
||||
'mongodb', 'sqlite', 'mysql', 'prisma', 'drizzle',
|
||||
'tailwind', 'css', 'html', 'sass', 'webpack', 'vite', 'esbuild',
|
||||
'git', 'ci', 'cd', 'testing', 'security', 'authentication',
|
||||
'api', 'cli', 'sdk', 'mcp', 'llm', 'ai', 'ml', 'openai', 'anthropic',
|
||||
]);
|
||||
|
||||
const TAG_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
||||
|
||||
export class AutoTagger {
|
||||
detectTags(content: ExtractedContent): string[] {
|
||||
const tagCounts = new Map<string, number>();
|
||||
|
||||
this.extractFromUrl(content.sourceUrl, tagCounts);
|
||||
this.extractFromHeadings(content.content, tagCounts);
|
||||
this.extractFromCodeBlocks(content.content, tagCounts);
|
||||
this.extractFromKeywords(content.content, tagCounts);
|
||||
|
||||
if (content.language) {
|
||||
this.addTag(content.language.toLowerCase(), tagCounts, 3);
|
||||
}
|
||||
|
||||
if (content.contentType !== 'text') {
|
||||
this.addTag(content.contentType, tagCounts, 1);
|
||||
}
|
||||
|
||||
return Array.from(tagCounts.entries())
|
||||
.sort((a, b) => b[1] - a[1])
|
||||
.slice(0, 10)
|
||||
.map(([tag]) => tag);
|
||||
}
|
||||
|
||||
private extractFromUrl(url: string | undefined, counts: Map<string, number>): void {
|
||||
if (!url) return;
|
||||
try {
|
||||
const parsed = new URL(url);
|
||||
const segments = parsed.pathname
|
||||
.split('/')
|
||||
.filter(Boolean)
|
||||
.map((s) => s.toLowerCase().replace(/[^a-z0-9-]/g, ''));
|
||||
|
||||
for (const seg of segments) {
|
||||
if (seg.length >= 2 && seg.length <= 30 && TAG_PATTERN.test(seg)) {
|
||||
this.addTag(seg, counts, 2);
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// not a valid URL, skip
|
||||
}
|
||||
}
|
||||
|
||||
private extractFromHeadings(content: string, counts: Map<string, number>): void {
|
||||
const headingRe = /^#{1,2}\s+(.+)$/gm;
|
||||
let match: RegExpExecArray | null;
|
||||
while ((match = headingRe.exec(content)) !== null) {
|
||||
const words = match[1].toLowerCase().split(/\s+/);
|
||||
for (const word of words) {
|
||||
const cleaned = word.replace(/[^a-z0-9-]/g, '');
|
||||
if (cleaned.length >= 2 && TAG_PATTERN.test(cleaned)) {
|
||||
this.addTag(cleaned, counts, 2);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private extractFromCodeBlocks(content: string, counts: Map<string, number>): void {
|
||||
const codeBlockRe = /^```(\w+)/gm;
|
||||
let match: RegExpExecArray | null;
|
||||
while ((match = codeBlockRe.exec(content)) !== null) {
|
||||
const lang = match[1].toLowerCase();
|
||||
if (lang.length >= 2 && TAG_PATTERN.test(lang)) {
|
||||
this.addTag(lang, counts, 3);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private extractFromKeywords(content: string, counts: Map<string, number>): void {
|
||||
const lower = content.toLowerCase();
|
||||
for (const keyword of TECH_KEYWORDS) {
|
||||
const re = new RegExp(`\\b${keyword}\\b`, 'i');
|
||||
if (re.test(lower)) {
|
||||
this.addTag(keyword, counts, 1);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
private addTag(tag: string, counts: Map<string, number>, weight: number): void {
|
||||
if (!TAG_PATTERN.test(tag)) return;
|
||||
counts.set(tag, (counts.get(tag) ?? 0) + weight);
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,17 @@
|
||||
export interface ExtractedContent {
|
||||
title: string;
|
||||
content: string;
|
||||
sourceUrl?: string;
|
||||
sourcePath?: string;
|
||||
tags: string[];
|
||||
extractedAt: string;
|
||||
contentType: 'webpage' | 'github' | 'text' | 'code' | 'file';
|
||||
language?: string;
|
||||
metadata: Record<string, string>;
|
||||
}
|
||||
|
||||
export interface ExtractionOptions {
|
||||
includeImages?: boolean;
|
||||
maxLength?: number;
|
||||
preferredTitle?: string;
|
||||
}
|
||||
@@ -0,0 +1,2 @@
|
||||
export * from './types.js';
|
||||
export * from './spec-validator.js';
|
||||
@@ -0,0 +1,128 @@
|
||||
import { readFileSync, existsSync } from 'node:fs';
|
||||
import { join, basename } from 'node:path';
|
||||
import { stripFrontmatter } from '../parser/index.js';
|
||||
import type { SpecValidationResult, SpecCheck, SpecValidationOptions } from './types.js';
|
||||
|
||||
const NAME_PATTERN = /^[a-z0-9]+(-[a-z0-9]+)*$/;
|
||||
const SPEC_VERSION = '1.0';
|
||||
|
||||
export class SpecValidator {
|
||||
validate(skillPath: string, options?: SpecValidationOptions): SpecValidationResult {
|
||||
const checks: SpecCheck[] = [];
|
||||
const errors: string[] = [];
|
||||
const warnings: string[] = [];
|
||||
|
||||
const skillMdPath = skillPath.endsWith('.md') ? skillPath : join(skillPath, 'SKILL.md');
|
||||
if (!existsSync(skillMdPath)) {
|
||||
errors.push(`SKILL.md not found at ${skillMdPath}`);
|
||||
return { valid: false, errors, warnings, specVersion: SPEC_VERSION, checks };
|
||||
}
|
||||
|
||||
const raw = readFileSync(skillMdPath, 'utf-8');
|
||||
const { frontmatter, body } = stripFrontmatter(raw);
|
||||
|
||||
const hasName = typeof frontmatter.name === 'string' && frontmatter.name.length > 0;
|
||||
checks.push({
|
||||
name: 'name-present',
|
||||
passed: hasName,
|
||||
message: hasName ? 'Name field is present' : 'Missing required "name" field in frontmatter',
|
||||
severity: hasName ? 'info' : 'error',
|
||||
});
|
||||
if (!hasName) errors.push('Missing required "name" field in frontmatter');
|
||||
|
||||
const hasDescription = typeof frontmatter.description === 'string' && frontmatter.description.length > 0;
|
||||
checks.push({
|
||||
name: 'description-present',
|
||||
passed: hasDescription,
|
||||
message: hasDescription ? 'Description field is present' : 'Missing required "description" field in frontmatter',
|
||||
severity: hasDescription ? 'info' : 'error',
|
||||
});
|
||||
if (!hasDescription) errors.push('Missing required "description" field in frontmatter');
|
||||
|
||||
if (hasName) {
|
||||
const nameStr = frontmatter.name as string;
|
||||
const nameValid = NAME_PATTERN.test(nameStr);
|
||||
checks.push({
|
||||
name: 'name-format',
|
||||
passed: nameValid,
|
||||
message: nameValid ? 'Name matches required pattern' : `Name "${nameStr}" does not match pattern: lowercase alphanumeric with hyphens`,
|
||||
severity: nameValid ? 'info' : 'error',
|
||||
});
|
||||
if (!nameValid) errors.push(`Name "${nameStr}" does not match pattern: lowercase alphanumeric with hyphens`);
|
||||
}
|
||||
|
||||
if (options?.strict) {
|
||||
if (frontmatter.version !== undefined) {
|
||||
warnings.push('version should be under metadata.skillkit-version');
|
||||
checks.push({
|
||||
name: 'version-placement',
|
||||
passed: false,
|
||||
message: 'version should be under metadata.skillkit-version',
|
||||
severity: 'warning',
|
||||
});
|
||||
}
|
||||
|
||||
if (frontmatter.author !== undefined) {
|
||||
warnings.push('author should be under metadata.skillkit-author');
|
||||
checks.push({
|
||||
name: 'author-placement',
|
||||
passed: false,
|
||||
message: 'author should be under metadata.skillkit-author',
|
||||
severity: 'warning',
|
||||
});
|
||||
}
|
||||
|
||||
if (frontmatter.tags !== undefined) {
|
||||
warnings.push('tags should be under metadata.skillkit-tags');
|
||||
checks.push({
|
||||
name: 'tags-placement',
|
||||
passed: false,
|
||||
message: 'tags should be under metadata.skillkit-tags',
|
||||
severity: 'warning',
|
||||
});
|
||||
}
|
||||
|
||||
if (frontmatter.agents !== undefined) {
|
||||
warnings.push('agents should be under metadata.skillkit-agents');
|
||||
checks.push({
|
||||
name: 'agents-placement',
|
||||
passed: false,
|
||||
message: 'agents should be under metadata.skillkit-agents',
|
||||
severity: 'warning',
|
||||
});
|
||||
}
|
||||
|
||||
if (hasName) {
|
||||
const skillDir = skillPath.endsWith('.md') ? join(skillPath, '..') : skillPath;
|
||||
const dirName = basename(skillDir);
|
||||
const nameStr = frontmatter.name as string;
|
||||
const nameMatchesDir = nameStr === dirName;
|
||||
checks.push({
|
||||
name: 'name-directory-match',
|
||||
passed: nameMatchesDir,
|
||||
message: nameMatchesDir ? 'Name matches directory' : `Name "${nameStr}" does not match directory "${dirName}"`,
|
||||
severity: nameMatchesDir ? 'info' : 'warning',
|
||||
});
|
||||
if (!nameMatchesDir) warnings.push(`Name "${nameStr}" does not match directory "${dirName}"`);
|
||||
}
|
||||
|
||||
const bodyLines = body.split('\n').length;
|
||||
const bodyWithinLimit = bodyLines <= 500;
|
||||
checks.push({
|
||||
name: 'body-length',
|
||||
passed: bodyWithinLimit,
|
||||
message: bodyWithinLimit ? `Body is ${bodyLines} lines` : `Body is ${bodyLines} lines (exceeds 500). Consider moving content to references/ directory`,
|
||||
severity: bodyWithinLimit ? 'info' : 'warning',
|
||||
});
|
||||
if (!bodyWithinLimit) warnings.push(`Body is ${bodyLines} lines (exceeds 500). Consider moving content to references/ directory`);
|
||||
}
|
||||
|
||||
return {
|
||||
valid: errors.length === 0,
|
||||
errors,
|
||||
warnings,
|
||||
specVersion: SPEC_VERSION,
|
||||
checks,
|
||||
};
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
export interface SpecValidationResult {
|
||||
valid: boolean;
|
||||
errors: string[];
|
||||
warnings: string[];
|
||||
specVersion: string;
|
||||
checks: SpecCheck[];
|
||||
}
|
||||
|
||||
export interface SpecCheck {
|
||||
name: string;
|
||||
passed: boolean;
|
||||
message: string;
|
||||
severity: 'error' | 'warning' | 'info';
|
||||
}
|
||||
|
||||
export interface SpecValidationOptions {
|
||||
strict?: boolean;
|
||||
}
|
||||
@@ -0,0 +1,46 @@
|
||||
# @skillkit/extension
|
||||
|
||||
Chrome extension to save any webpage as an AI agent skill. No server needed.
|
||||
|
||||
## Install
|
||||
|
||||
```bash
|
||||
pnpm --filter @skillkit/extension build
|
||||
```
|
||||
|
||||
Then in Chrome:
|
||||
|
||||
1. Open `chrome://extensions`
|
||||
2. Enable "Developer mode"
|
||||
3. Click "Load unpacked"
|
||||
4. Select `packages/extension/dist/`
|
||||
|
||||
## Usage
|
||||
|
||||
- Click the extension icon → **Save as Skill**
|
||||
- Right-click any page → **Save page as Skill**
|
||||
- Select text → right-click → **Save selection as Skill**
|
||||
|
||||
Skills download to `Downloads/skillkit-skills/{name}/SKILL.md`.
|
||||
|
||||
To make available to all 44 agents:
|
||||
|
||||
```bash
|
||||
skillkit install ~/Downloads/skillkit-skills/my-skill
|
||||
```
|
||||
|
||||
## How It Works
|
||||
|
||||
Everything runs in the browser:
|
||||
|
||||
1. **Content script** converts page HTML to markdown via Turndown
|
||||
2. **Background worker** generates SKILL.md with YAML frontmatter and auto-tags
|
||||
3. **Downloads API** saves the file — no server calls
|
||||
|
||||
## Build
|
||||
|
||||
```bash
|
||||
pnpm --filter @skillkit/extension build
|
||||
```
|
||||
|
||||
Output: `dist/` with manifest, JS bundles (IIFE), popup UI, and icons.
|
||||
@@ -0,0 +1,21 @@
|
||||
{
|
||||
"name": "@skillkit/extension",
|
||||
"version": "1.17.0",
|
||||
"private": true,
|
||||
"description": "Chrome extension to save any webpage as an AI agent skill",
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "tsup && cp src/manifest.json dist/ && cp src/popup.html dist/ && cp src/popup.css dist/ && cp -r src/icons dist/",
|
||||
"dev": "tsup --watch",
|
||||
"typecheck": "tsc --noEmit"
|
||||
},
|
||||
"dependencies": {
|
||||
"turndown": "^7.2.2"
|
||||
},
|
||||
"devDependencies": {
|
||||
"@types/chrome": "^0.0.280",
|
||||
"@types/turndown": "^5.0.6",
|
||||
"tsup": "^8.3.5",
|
||||
"typescript": "^5.7.2"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,159 @@
|
||||
import type { SaveResponse, ErrorResponse, ExtensionMessage } from './types';
|
||||
|
||||
const TECH_KEYWORDS = new Set([
|
||||
'react', 'vue', 'angular', 'svelte', 'next', 'nuxt', 'node', 'deno', 'bun',
|
||||
'typescript', 'javascript', 'python', 'rust', 'go', 'java', 'kotlin', 'swift',
|
||||
'docker', 'kubernetes', 'aws', 'gcp', 'azure', 'terraform', 'ansible',
|
||||
'graphql', 'rest', 'api', 'sql', 'nosql', 'redis', 'postgres', 'mongodb',
|
||||
'testing', 'ci', 'cd', 'git', 'webpack', 'vite', 'tailwind', 'css',
|
||||
'ai', 'ml', 'llm', 'mcp', 'agent', 'prompt', 'rag', 'embedding',
|
||||
]);
|
||||
|
||||
chrome.runtime.onInstalled.addListener(() => {
|
||||
chrome.contextMenus.create({
|
||||
id: 'save-page',
|
||||
title: 'Save page as Skill',
|
||||
contexts: ['page'],
|
||||
});
|
||||
|
||||
chrome.contextMenus.create({
|
||||
id: 'save-selection',
|
||||
title: 'Save selection as Skill',
|
||||
contexts: ['selection'],
|
||||
});
|
||||
});
|
||||
|
||||
chrome.contextMenus.onClicked.addListener(async (info, tab) => {
|
||||
if (!tab?.id) return;
|
||||
|
||||
try {
|
||||
if (info.menuItemId === 'save-page') {
|
||||
const pageInfo = await chrome.tabs.sendMessage(tab.id, { type: 'GET_PAGE_INFO' });
|
||||
if (pageInfo?.type === 'PAGE_INFO') {
|
||||
const { url, title, markdown } = pageInfo.payload;
|
||||
const result = generateAndDownload({ url, title, content: markdown });
|
||||
notifyTab(tab.id, result);
|
||||
}
|
||||
}
|
||||
|
||||
if (info.menuItemId === 'save-selection' && info.selectionText) {
|
||||
const url = tab.url ?? '';
|
||||
const result = generateAndDownload({ url, title: '', content: info.selectionText });
|
||||
notifyTab(tab.id, result);
|
||||
}
|
||||
} catch {
|
||||
notifyTab(tab.id, { error: 'Failed to extract page content' });
|
||||
}
|
||||
});
|
||||
|
||||
chrome.runtime.onMessage.addListener(
|
||||
(message: ExtensionMessage, _sender, sendResponse) => {
|
||||
if (message.type === 'SAVE_PAGE') {
|
||||
const { url, title, markdown, name } = message.payload;
|
||||
sendResponse(generateAndDownload({ url, title, content: markdown, name }));
|
||||
} else if (message.type === 'SAVE_SELECTION') {
|
||||
const { text, url, name } = message.payload;
|
||||
sendResponse(generateAndDownload({ url, title: '', content: text, name }));
|
||||
}
|
||||
return false;
|
||||
},
|
||||
);
|
||||
|
||||
interface GenerateInput {
|
||||
url: string;
|
||||
title: string;
|
||||
content: string;
|
||||
name?: string;
|
||||
}
|
||||
|
||||
function generateAndDownload(input: GenerateInput): SaveResponse | ErrorResponse {
|
||||
try {
|
||||
const name = slugify(input.name || input.title || titleFromUrl(input.url));
|
||||
const tags = detectTags(input.url, input.content);
|
||||
const description = makeDescription(input.content);
|
||||
const savedAt = new Date().toISOString();
|
||||
|
||||
const yamlTags = tags.length > 0
|
||||
? `tags:\n${tags.map((t) => ` - ${t}`).join('\n')}\n`
|
||||
: '';
|
||||
|
||||
const skillMd =
|
||||
`---\n` +
|
||||
`name: ${name}\n` +
|
||||
`description: ${yamlEscape(description)}\n` +
|
||||
yamlTags +
|
||||
`metadata:\n` +
|
||||
(input.url ? ` source: ${input.url}\n` : '') +
|
||||
` savedAt: ${savedAt}\n` +
|
||||
`---\n\n` +
|
||||
input.content + '\n';
|
||||
|
||||
const filename = `${name}/SKILL.md`;
|
||||
|
||||
const blob = new Blob([skillMd], { type: 'text/markdown' });
|
||||
const blobUrl = URL.createObjectURL(blob);
|
||||
|
||||
chrome.downloads.download({
|
||||
url: blobUrl,
|
||||
filename: `skillkit-skills/${filename}`,
|
||||
saveAs: false,
|
||||
}, () => {
|
||||
URL.revokeObjectURL(blobUrl);
|
||||
});
|
||||
|
||||
return { name, filename, skillMd, tags };
|
||||
} catch (err) {
|
||||
return { error: err instanceof Error ? err.message : 'Generation failed' };
|
||||
}
|
||||
}
|
||||
|
||||
function slugify(input: string): string {
|
||||
const slug = input
|
||||
.toLowerCase()
|
||||
.replace(/[^a-z0-9]+/g, '-')
|
||||
.replace(/^-+|-+$/g, '')
|
||||
.replace(/-{2,}/g, '-');
|
||||
return slug.slice(0, 64).replace(/-+$/, '') || 'untitled-skill';
|
||||
}
|
||||
|
||||
function titleFromUrl(url: string): string {
|
||||
try {
|
||||
const pathname = new URL(url).pathname;
|
||||
const last = pathname.split('/').filter(Boolean).pop();
|
||||
return last ?? 'untitled';
|
||||
} catch {
|
||||
return 'untitled';
|
||||
}
|
||||
}
|
||||
|
||||
function makeDescription(content: string): string {
|
||||
const firstLine = content.split('\n').find((l) => l.trim().length > 0) ?? '';
|
||||
const cleaned = firstLine.replace(/^#+\s*/, '').trim();
|
||||
if (cleaned.length > 200) return cleaned.slice(0, 197) + '...';
|
||||
return cleaned || 'Saved skill';
|
||||
}
|
||||
|
||||
function yamlEscape(value: string): string {
|
||||
const singleLine = value.replace(/\r?\n/g, ' ').trim();
|
||||
if (/[:#{}[\],&*?|>!%@`]/.test(singleLine) || singleLine.startsWith("'") || singleLine.startsWith('"')) {
|
||||
return `"${singleLine.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
|
||||
}
|
||||
return singleLine;
|
||||
}
|
||||
|
||||
function detectTags(url: string, content: string): string[] {
|
||||
const text = `${url} ${content}`.toLowerCase();
|
||||
const found: string[] = [];
|
||||
for (const kw of TECH_KEYWORDS) {
|
||||
if (text.includes(kw)) found.push(kw);
|
||||
if (found.length >= 10) break;
|
||||
}
|
||||
return found;
|
||||
}
|
||||
|
||||
function notifyTab(tabId: number, result: SaveResponse | ErrorResponse): void {
|
||||
const isError = 'error' in result;
|
||||
chrome.action.setBadgeText({ text: isError ? '!' : '\u2713', tabId });
|
||||
chrome.action.setBadgeBackgroundColor({ color: isError ? '#ef4444' : '#22c55e', tabId });
|
||||
setTimeout(() => chrome.action.setBadgeText({ text: '', tabId }), 3000);
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
import TurndownService from 'turndown';
|
||||
import type { ExtensionMessage, PageContent } from './types';
|
||||
|
||||
const turndown = new TurndownService({
|
||||
headingStyle: 'atx',
|
||||
codeBlockStyle: 'fenced',
|
||||
});
|
||||
|
||||
turndown.remove(['script', 'style', 'nav', 'footer', 'iframe', 'noscript']);
|
||||
|
||||
function extractPageContent(): PageContent {
|
||||
const selection = window.getSelection()?.toString() ?? '';
|
||||
const description =
|
||||
document.querySelector('meta[name="description"]')?.getAttribute('content') ?? '';
|
||||
|
||||
const article = document.querySelector('article, main, [role="main"]');
|
||||
const source = article ?? document.body;
|
||||
const markdown = turndown.turndown(source.innerHTML);
|
||||
|
||||
return {
|
||||
url: window.location.href,
|
||||
title: document.title || description || window.location.hostname,
|
||||
markdown,
|
||||
selection,
|
||||
description,
|
||||
};
|
||||
}
|
||||
|
||||
chrome.runtime.onMessage.addListener(
|
||||
(message: ExtensionMessage, _sender, sendResponse) => {
|
||||
if (message.type === 'GET_PAGE_INFO') {
|
||||
const content = extractPageContent();
|
||||
const response: ExtensionMessage = { type: 'PAGE_INFO', payload: content };
|
||||
sendResponse(response);
|
||||
}
|
||||
return false;
|
||||
},
|
||||
);
|
||||
@@ -0,0 +1,8 @@
|
||||
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" fill="none">
|
||||
<rect width="128" height="128" rx="16" fill="#09090b"/>
|
||||
<text x="64" y="52" text-anchor="middle" font-family="monospace" font-size="18" font-weight="700" fill="#fafafa">SK</text>
|
||||
<rect x="28" y="64" width="72" height="2" rx="1" fill="#52525b"/>
|
||||
<rect x="34" y="74" width="24" height="6" rx="3" fill="#71717a"/>
|
||||
<rect x="62" y="74" width="32" height="6" rx="3" fill="#71717a"/>
|
||||
<rect x="40" y="84" width="48" height="6" rx="3" fill="#3f3f46"/>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 537 B |
|
After Width: | Height: | Size: 3.2 KiB |
|
After Width: | Height: | Size: 1.1 KiB |
|
After Width: | Height: | Size: 2.7 KiB |
@@ -0,0 +1,29 @@
|
||||
{
|
||||
"manifest_version": 3,
|
||||
"name": "SkillKit - Save as Skill",
|
||||
"version": "1.17.0",
|
||||
"description": "Save any webpage as an AI agent skill — instantly available across 44 agents",
|
||||
"permissions": ["contextMenus", "activeTab", "storage", "downloads"],
|
||||
"background": {
|
||||
"service_worker": "background.global.js"
|
||||
},
|
||||
"action": {
|
||||
"default_popup": "popup.html",
|
||||
"default_icon": {
|
||||
"16": "icons/icon16.png",
|
||||
"48": "icons/icon48.png",
|
||||
"128": "icons/icon128.png"
|
||||
}
|
||||
},
|
||||
"content_scripts": [
|
||||
{
|
||||
"matches": ["<all_urls>"],
|
||||
"js": ["content.global.js"]
|
||||
}
|
||||
],
|
||||
"icons": {
|
||||
"16": "icons/icon16.png",
|
||||
"48": "icons/icon48.png",
|
||||
"128": "icons/icon128.png"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,195 @@
|
||||
* {
|
||||
margin: 0;
|
||||
padding: 0;
|
||||
box-sizing: border-box;
|
||||
}
|
||||
|
||||
body {
|
||||
width: 360px;
|
||||
font-family: 'Inter', -apple-system, BlinkMacSystemFont, sans-serif;
|
||||
background: #09090b;
|
||||
color: #fafafa;
|
||||
font-size: 13px;
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
#app {
|
||||
padding: 16px;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 12px;
|
||||
}
|
||||
|
||||
header {
|
||||
display: flex;
|
||||
align-items: baseline;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
header h1 {
|
||||
font-size: 16px;
|
||||
font-weight: 700;
|
||||
letter-spacing: -0.02em;
|
||||
}
|
||||
|
||||
.subtitle {
|
||||
font-size: 12px;
|
||||
color: #71717a;
|
||||
}
|
||||
|
||||
.field {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 4px;
|
||||
}
|
||||
|
||||
.field label {
|
||||
font-size: 11px;
|
||||
font-weight: 500;
|
||||
color: #a1a1aa;
|
||||
text-transform: uppercase;
|
||||
letter-spacing: 0.05em;
|
||||
}
|
||||
|
||||
.field span {
|
||||
font-size: 13px;
|
||||
color: #d4d4d8;
|
||||
}
|
||||
|
||||
.truncate {
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.mono {
|
||||
font-family: 'JetBrains Mono', 'SF Mono', monospace;
|
||||
font-size: 11px;
|
||||
}
|
||||
|
||||
#page-info {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 8px;
|
||||
padding: 10px;
|
||||
background: #18181b;
|
||||
border-radius: 6px;
|
||||
border: 1px solid #27272a;
|
||||
}
|
||||
|
||||
.form {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 10px;
|
||||
}
|
||||
|
||||
input[type="text"] {
|
||||
width: 100%;
|
||||
padding: 8px 10px;
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
border-radius: 6px;
|
||||
color: #fafafa;
|
||||
font-size: 13px;
|
||||
font-family: inherit;
|
||||
outline: none;
|
||||
transition: border-color 0.15s;
|
||||
}
|
||||
|
||||
input[type="text"]:focus {
|
||||
border-color: #52525b;
|
||||
}
|
||||
|
||||
input[type="text"]::placeholder {
|
||||
color: #52525b;
|
||||
}
|
||||
|
||||
.checkbox-field {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
}
|
||||
|
||||
.checkbox-field input[type="checkbox"] {
|
||||
width: 14px;
|
||||
height: 14px;
|
||||
accent-color: #fafafa;
|
||||
}
|
||||
|
||||
.checkbox-field label {
|
||||
font-size: 12px;
|
||||
color: #a1a1aa;
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
button {
|
||||
width: 100%;
|
||||
padding: 10px;
|
||||
border: none;
|
||||
border-radius: 6px;
|
||||
font-size: 13px;
|
||||
font-weight: 600;
|
||||
cursor: pointer;
|
||||
transition: opacity 0.15s;
|
||||
}
|
||||
|
||||
button:hover {
|
||||
opacity: 0.9;
|
||||
}
|
||||
|
||||
button:disabled {
|
||||
opacity: 0.5;
|
||||
cursor: not-allowed;
|
||||
}
|
||||
|
||||
button.primary {
|
||||
background: #fafafa;
|
||||
color: #09090b;
|
||||
}
|
||||
|
||||
button.secondary {
|
||||
background: #27272a;
|
||||
color: #d4d4d8;
|
||||
margin-top: -4px;
|
||||
}
|
||||
|
||||
.status {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
padding: 8px 10px;
|
||||
border-radius: 6px;
|
||||
font-size: 12px;
|
||||
}
|
||||
|
||||
.status.saving {
|
||||
background: #18181b;
|
||||
border: 1px solid #27272a;
|
||||
color: #a1a1aa;
|
||||
}
|
||||
|
||||
.status.success {
|
||||
background: #052e16;
|
||||
border: 1px solid #166534;
|
||||
color: #4ade80;
|
||||
}
|
||||
|
||||
.status.error {
|
||||
background: #450a0a;
|
||||
border: 1px solid #991b1b;
|
||||
color: #fca5a5;
|
||||
}
|
||||
|
||||
#result {
|
||||
padding: 10px;
|
||||
background: #18181b;
|
||||
border-radius: 6px;
|
||||
border: 1px solid #27272a;
|
||||
}
|
||||
|
||||
.hint {
|
||||
margin-top: 8px;
|
||||
font-size: 11px;
|
||||
color: #52525b;
|
||||
font-family: 'JetBrains Mono', 'SF Mono', monospace;
|
||||
}
|
||||
@@ -0,0 +1,53 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="UTF-8">
|
||||
<meta name="viewport" content="width=360">
|
||||
<title>SkillKit</title>
|
||||
<link rel="stylesheet" href="popup.css">
|
||||
</head>
|
||||
<body>
|
||||
<div id="app">
|
||||
<header>
|
||||
<h1>SkillKit</h1>
|
||||
<p class="subtitle">Save as Skill</p>
|
||||
</header>
|
||||
|
||||
<div id="page-info">
|
||||
<div class="field">
|
||||
<label>Page</label>
|
||||
<span id="page-title" class="truncate">Loading...</span>
|
||||
</div>
|
||||
<div class="field">
|
||||
<label>URL</label>
|
||||
<span id="page-url" class="truncate mono">—</span>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="form">
|
||||
<div class="field">
|
||||
<label for="skill-name">Skill name (optional)</label>
|
||||
<input type="text" id="skill-name" placeholder="auto-generated from title">
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<button id="save-btn" class="primary">Save as Skill</button>
|
||||
<button id="save-selection-btn" class="secondary" style="display:none">Save Selection as Skill</button>
|
||||
|
||||
<div id="status" class="status" style="display:none">
|
||||
<span id="status-icon"></span>
|
||||
<span id="status-text"></span>
|
||||
</div>
|
||||
|
||||
<div id="result" style="display:none">
|
||||
<div class="field">
|
||||
<label>Downloaded to</label>
|
||||
<span id="result-path" class="mono truncate"></span>
|
||||
</div>
|
||||
<p class="hint">Run <code>skillkit install <path></code> to make available to all agents</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<script src="popup.global.js"></script>
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,111 @@
|
||||
import type { ExtensionMessage, SaveResponse, ErrorResponse } from './types';
|
||||
|
||||
const pageTitle = document.getElementById('page-title')!;
|
||||
const pageUrl = document.getElementById('page-url')!;
|
||||
const skillNameInput = document.getElementById('skill-name') as HTMLInputElement;
|
||||
const saveBtn = document.getElementById('save-btn')!;
|
||||
const saveSelectionBtn = document.getElementById('save-selection-btn')!;
|
||||
const statusEl = document.getElementById('status')!;
|
||||
const statusIcon = document.getElementById('status-icon')!;
|
||||
const statusText = document.getElementById('status-text')!;
|
||||
const resultEl = document.getElementById('result')!;
|
||||
const resultPath = document.getElementById('result-path')!;
|
||||
|
||||
let currentUrl = '';
|
||||
let currentSelection = '';
|
||||
let currentMarkdown = '';
|
||||
let currentTitle = '';
|
||||
|
||||
async function init() {
|
||||
const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
|
||||
if (!tab?.id) return;
|
||||
|
||||
pageTitle.textContent = tab.title || 'Unknown';
|
||||
pageUrl.textContent = tab.url || '\u2014';
|
||||
currentUrl = tab.url || '';
|
||||
currentTitle = tab.title || '';
|
||||
|
||||
try {
|
||||
const response = await chrome.tabs.sendMessage(
|
||||
tab.id,
|
||||
{ type: 'GET_PAGE_INFO' } satisfies ExtensionMessage,
|
||||
);
|
||||
if (response?.type === 'PAGE_INFO') {
|
||||
currentMarkdown = response.payload.markdown;
|
||||
currentSelection = response.payload.selection;
|
||||
currentTitle = response.payload.title || currentTitle;
|
||||
if (currentSelection) {
|
||||
saveSelectionBtn.style.display = 'block';
|
||||
}
|
||||
}
|
||||
} catch {
|
||||
// Content script not loaded (chrome:// pages, etc.)
|
||||
}
|
||||
}
|
||||
|
||||
saveBtn.addEventListener('click', async () => {
|
||||
if (!currentUrl) return;
|
||||
await save({
|
||||
type: 'SAVE_PAGE',
|
||||
payload: {
|
||||
url: currentUrl,
|
||||
title: currentTitle,
|
||||
markdown: currentMarkdown,
|
||||
name: skillNameInput.value.trim() || undefined,
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
saveSelectionBtn.addEventListener('click', async () => {
|
||||
if (!currentSelection) return;
|
||||
await save({
|
||||
type: 'SAVE_SELECTION',
|
||||
payload: {
|
||||
text: currentSelection,
|
||||
url: currentUrl,
|
||||
name: skillNameInput.value.trim() || undefined,
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
function setButtonsDisabled(disabled: boolean): void {
|
||||
const method = disabled ? 'setAttribute' : 'removeAttribute';
|
||||
saveBtn[method]('disabled', '');
|
||||
saveSelectionBtn[method]('disabled', '');
|
||||
}
|
||||
|
||||
async function save(message: ExtensionMessage) {
|
||||
setStatus('saving', 'Saving...');
|
||||
setButtonsDisabled(true);
|
||||
|
||||
const response: SaveResponse | ErrorResponse | undefined =
|
||||
await chrome.runtime.sendMessage(message);
|
||||
|
||||
setButtonsDisabled(false);
|
||||
|
||||
if (!response) {
|
||||
setStatus('error', 'No response from background script');
|
||||
resultEl.style.display = 'none';
|
||||
return;
|
||||
}
|
||||
|
||||
if ('error' in response) {
|
||||
setStatus('error', response.error);
|
||||
resultEl.style.display = 'none';
|
||||
return;
|
||||
}
|
||||
|
||||
setStatus('success', `Saved "${response.name}"`);
|
||||
resultPath.textContent = `Downloads/skillkit-skills/${response.filename}`;
|
||||
resultEl.style.display = 'block';
|
||||
}
|
||||
|
||||
function setStatus(type: 'saving' | 'success' | 'error', text: string) {
|
||||
statusEl.style.display = 'flex';
|
||||
statusEl.className = `status ${type}`;
|
||||
const icons = { saving: '...', success: '\u2713', error: '\u2717' };
|
||||
statusIcon.textContent = icons[type];
|
||||
statusText.textContent = text;
|
||||
}
|
||||
|
||||
init();
|
||||
@@ -0,0 +1,24 @@
|
||||
export interface SaveResponse {
|
||||
name: string;
|
||||
filename: string;
|
||||
skillMd: string;
|
||||
tags: string[];
|
||||
}
|
||||
|
||||
export interface ErrorResponse {
|
||||
error: string;
|
||||
}
|
||||
|
||||
export interface PageContent {
|
||||
url: string;
|
||||
title: string;
|
||||
markdown: string;
|
||||
selection: string;
|
||||
description: string;
|
||||
}
|
||||
|
||||
export type ExtensionMessage =
|
||||
| { type: 'SAVE_PAGE'; payload: { url: string; title: string; markdown: string; name?: string } }
|
||||
| { type: 'SAVE_SELECTION'; payload: { text: string; url: string; name?: string } }
|
||||
| { type: 'GET_PAGE_INFO' }
|
||||
| { type: 'PAGE_INFO'; payload: PageContent };
|
||||
@@ -0,0 +1,53 @@
|
||||
# Chrome Web Store Listing
|
||||
|
||||
## Title
|
||||
SkillKit - Save as Skill
|
||||
|
||||
## Summary (132 chars max)
|
||||
Save any webpage as an AI agent skill. One click, works across 44 coding agents. No server needed.
|
||||
|
||||
## Description
|
||||
SkillKit lets you save any webpage as a reusable AI agent skill with one click. The saved SKILL.md file works instantly across 44 coding agents including Claude Code, Cursor, Codex, Gemini CLI, Windsurf, and more.
|
||||
|
||||
How it works:
|
||||
- Click the extension icon to save the current page as a skill
|
||||
- Right-click any page and select "Save page as Skill"
|
||||
- Select text, right-click, and choose "Save selection as Skill"
|
||||
|
||||
Everything runs in the browser. No server, no API key, no account needed. Pages are converted to clean markdown with auto-generated YAML frontmatter and smart tags.
|
||||
|
||||
After saving, run `skillkit install <path>` to make the skill available to all your AI coding agents at once.
|
||||
|
||||
Features:
|
||||
- Converts HTML to clean markdown
|
||||
- Auto-generates YAML frontmatter with metadata
|
||||
- Smart tag detection from 40+ tech keywords
|
||||
- Context menu integration for quick saves
|
||||
- Works on any webpage
|
||||
- Zero dependencies on external servers
|
||||
|
||||
Part of the SkillKit ecosystem: https://agenstskills.com
|
||||
|
||||
## Category
|
||||
Developer Tools
|
||||
|
||||
## Language
|
||||
English
|
||||
|
||||
## Website
|
||||
https://agenstskills.com
|
||||
|
||||
## Support URL
|
||||
https://github.com/rohitg00/skillkit/issues
|
||||
|
||||
## Privacy Policy
|
||||
This extension does not collect, transmit, or store any user data externally. All processing happens locally in the browser. Saved skills are downloaded to the local filesystem via the Chrome Downloads API.
|
||||
|
||||
## Single Purpose
|
||||
Save webpages as AI agent skill files (SKILL.md) for use with coding AI agents.
|
||||
|
||||
## Assets
|
||||
- promo-small-440x280.png — Small promo tile
|
||||
- screenshot-1-1280x800.png — Popup UI showing save flow
|
||||
- screenshot-2-1280x800.png — Context menu integration
|
||||
- ../src/icons/icon128.png — Extension icon (128x128)
|
||||
|
After Width: | Height: | Size: 954 B |
|
After Width: | Height: | Size: 7.0 KiB |
|
After Width: | Height: | Size: 30 KiB |
|
After Width: | Height: | Size: 29 KiB |
@@ -0,0 +1,15 @@
|
||||
{
|
||||
"compilerOptions": {
|
||||
"target": "ES2020",
|
||||
"lib": ["ES2020", "DOM"],
|
||||
"module": "ESNext",
|
||||
"moduleResolution": "bundler",
|
||||
"strict": true,
|
||||
"esModuleInterop": true,
|
||||
"skipLibCheck": true,
|
||||
"outDir": "dist",
|
||||
"rootDir": "src",
|
||||
"types": ["chrome"]
|
||||
},
|
||||
"include": ["src/**/*.ts"]
|
||||
}
|
||||
@@ -0,0 +1,15 @@
|
||||
import { defineConfig } from 'tsup';
|
||||
|
||||
export default defineConfig({
|
||||
entry: {
|
||||
background: 'src/background.ts',
|
||||
content: 'src/content.ts',
|
||||
popup: 'src/popup.ts',
|
||||
},
|
||||
format: ['iife'],
|
||||
target: 'es2020',
|
||||
platform: 'browser',
|
||||
outDir: 'dist',
|
||||
clean: true,
|
||||
noExternal: [/.*/],
|
||||
});
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mcp-memory",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "MCP (Model Context Protocol) server for SkillKit persistent memory",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -0,0 +1,2 @@
|
||||
dist/
|
||||
data/
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mcp",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "MCP server for SkillKit skill discovery — agent-native skill search",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
@@ -15,9 +15,11 @@
|
||||
}
|
||||
},
|
||||
"files": [
|
||||
"dist"
|
||||
"dist",
|
||||
"data"
|
||||
],
|
||||
"scripts": {
|
||||
"prebuild": "mkdir -p data && cp ../../marketplace/skills.json data/skills.json",
|
||||
"build": "tsup",
|
||||
"dev": "tsup --watch",
|
||||
"typecheck": "tsc --noEmit",
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
import { Server } from '@modelcontextprotocol/sdk/server/index.js';
|
||||
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { realpathSync } from 'node:fs';
|
||||
import {
|
||||
CallToolRequestSchema,
|
||||
ListToolsRequestSchema,
|
||||
@@ -22,10 +23,12 @@ async function loadSkills(): Promise<SkillEntry[]> {
|
||||
const { readFileSync } = await import('node:fs');
|
||||
const { join, dirname } = await import('node:path');
|
||||
|
||||
const pkgDir = dirname(fileURLToPath(import.meta.url));
|
||||
const possiblePaths = [
|
||||
join(pkgDir, '..', 'data', 'skills.json'),
|
||||
join(pkgDir, '..', '..', '..', 'marketplace', 'skills.json'),
|
||||
join(pkgDir, '..', '..', 'marketplace', 'skills.json'),
|
||||
join(process.cwd(), 'marketplace', 'skills.json'),
|
||||
join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'marketplace', 'skills.json'),
|
||||
join(dirname(fileURLToPath(import.meta.url)), '..', '..', 'marketplace', 'skills.json'),
|
||||
];
|
||||
|
||||
for (const path of possiblePaths) {
|
||||
@@ -52,7 +55,7 @@ async function loadSkills(): Promise<SkillEntry[]> {
|
||||
const server = new Server(
|
||||
{
|
||||
name: 'skillkit-discovery',
|
||||
version: '1.12.0',
|
||||
version: '1.17.0',
|
||||
},
|
||||
{
|
||||
capabilities: {
|
||||
@@ -212,7 +215,12 @@ async function main() {
|
||||
console.error('SkillKit Discovery MCP Server running on stdio');
|
||||
}
|
||||
|
||||
const isMain = process.argv[1] === fileURLToPath(import.meta.url);
|
||||
let isMain = false;
|
||||
try {
|
||||
const resolvedArgv = process.argv[1] ? realpathSync(process.argv[1]) : '';
|
||||
const resolvedModule = realpathSync(fileURLToPath(import.meta.url));
|
||||
isMain = resolvedArgv === resolvedModule;
|
||||
} catch {}
|
||||
if (isMain) {
|
||||
main().catch((error) => {
|
||||
console.error('Fatal error:', error);
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/memory",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "CozoDB-backed semantic memory with embeddings for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/mesh",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Peer mesh network for multi-machine agent distribution",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/messaging",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Inter-agent messaging system for SkillKit",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/resources",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "@skillkit/tui",
|
||||
"version": "1.16.0",
|
||||
"version": "1.17.0",
|
||||
"description": "Unified Terminal UI for SkillKit - Built on OpenTUI",
|
||||
"type": "module",
|
||||
"main": "./dist/index.js",
|
||||
|
||||
@@ -186,9 +186,15 @@ importers:
|
||||
|
||||
packages/core:
|
||||
dependencies:
|
||||
'@mozilla/readability':
|
||||
specifier: ^0.6.0
|
||||
version: 0.6.0
|
||||
minimatch:
|
||||
specifier: ^10.1.1
|
||||
version: 10.1.1
|
||||
turndown:
|
||||
specifier: ^7.2.2
|
||||
version: 7.2.2
|
||||
yaml:
|
||||
specifier: ^2.6.1
|
||||
version: 2.8.2
|
||||
@@ -224,6 +230,9 @@ importers:
|
||||
'@types/node':
|
||||
specifier: ^22.10.5
|
||||
version: 22.19.7
|
||||
'@types/turndown':
|
||||
specifier: ^5.0.6
|
||||
version: 5.0.6
|
||||
tsup:
|
||||
specifier: ^8.3.5
|
||||
version: 8.5.1(jiti@2.6.1)(postcss@8.5.6)(typescript@5.9.3)(yaml@2.8.2)
|
||||
@@ -234,6 +243,25 @@ importers:
|
||||
specifier: ^2.1.8
|
||||
version: 2.1.9(@types/node@22.19.7)(lightningcss@1.30.2)
|
||||
|
||||
packages/extension:
|
||||
dependencies:
|
||||
turndown:
|
||||
specifier: ^7.2.2
|
||||
version: 7.2.2
|
||||
devDependencies:
|
||||
'@types/chrome':
|
||||
specifier: ^0.0.280
|
||||
version: 0.0.280
|
||||
'@types/turndown':
|
||||
specifier: ^5.0.6
|
||||
version: 5.0.6
|
||||
tsup:
|
||||
specifier: ^8.3.5
|
||||
version: 8.5.1(jiti@2.6.1)(postcss@8.5.6)(typescript@5.9.3)(yaml@2.8.2)
|
||||
typescript:
|
||||
specifier: ^5.7.2
|
||||
version: 5.9.3
|
||||
|
||||
packages/mcp:
|
||||
dependencies:
|
||||
'@modelcontextprotocol/sdk':
|
||||
@@ -391,10 +419,10 @@ importers:
|
||||
dependencies:
|
||||
'@opentui/core':
|
||||
specifier: ^0.1.75
|
||||
version: 0.1.75(stage-js@1.0.0-alpha.17)(typescript@5.9.3)(web-tree-sitter@0.25.10)
|
||||
version: 0.1.75(stage-js@1.0.1)(typescript@5.9.3)(web-tree-sitter@0.25.10)
|
||||
'@opentui/solid':
|
||||
specifier: ^0.1.75
|
||||
version: 0.1.75(solid-js@1.9.11)(stage-js@1.0.0-alpha.17)(typescript@5.9.3)(web-tree-sitter@0.25.10)
|
||||
version: 0.1.75(solid-js@1.9.11)(stage-js@1.0.1)(typescript@5.9.3)(web-tree-sitter@0.25.10)
|
||||
'@skillkit/agents':
|
||||
specifier: workspace:*
|
||||
version: link:../agents
|
||||
@@ -1043,6 +1071,9 @@ packages:
|
||||
resolution: {integrity: sha512-Yhlar6v9WQgUp/He7BdgzOz8lqMQ8sU+jkCq7Wx8Myc5YFJLbEe7lgui/V7G1qB1DJykHSGwreceSaD60Y0PUQ==}
|
||||
hasBin: true
|
||||
|
||||
'@mixmark-io/domino@2.2.0':
|
||||
resolution: {integrity: sha512-Y28PR25bHXUg88kCV7nivXrP2Nj2RueZ3/l/jdx6J9f8J4nsEGcgX0Qe6lt7Pa+J79+kPiJU3LguR6O/6zrLOw==}
|
||||
|
||||
'@modelcontextprotocol/sdk@1.25.3':
|
||||
resolution: {integrity: sha512-vsAMBMERybvYgKbg/l4L1rhS7VXV1c0CtyJg72vwxONVX0l4ZfKVAnZEWTQixJGTzKnELjQ59e4NbdFDALRiAQ==}
|
||||
engines: {node: '>=18'}
|
||||
@@ -1053,6 +1084,10 @@ packages:
|
||||
'@cfworker/json-schema':
|
||||
optional: true
|
||||
|
||||
'@mozilla/readability@0.6.0':
|
||||
resolution: {integrity: sha512-juG5VWh4qAivzTAeMzvY9xs9HY5rAcr2E4I7tiSSCokRFi7XIZCAu92ZkSTsIj1OPceCifL3cpfteP3pDT9/QQ==}
|
||||
engines: {node: '>=14.0.0'}
|
||||
|
||||
'@noble/ciphers@1.3.0':
|
||||
resolution: {integrity: sha512-2I0gnIVPtfnMw9ee9h1dJG7tp81+8Ob3OJb3Mv37rx5L40/b0i7djjCVvGOVqc9AEIQyvyu1i6ypKdFw8R8gQw==}
|
||||
engines: {node: ^14.21.3 || >=16}
|
||||
@@ -1527,9 +1562,21 @@ packages:
|
||||
'@types/better-sqlite3@7.6.13':
|
||||
resolution: {integrity: sha512-NMv9ASNARoKksWtsq/SHakpYAYnhBrQgGD8zkLYk/jaK8jUGn08CfEdTRgYhMypUQAfzSP8W6gNLe0q19/t4VA==}
|
||||
|
||||
'@types/chrome@0.0.280':
|
||||
resolution: {integrity: sha512-AotSmZrL9bcZDDmSI1D9dE7PGbhOur5L0cKxXd7IqbVizQWCY4gcvupPUVsQ4FfDj3V2tt/iOpomT9EY0s+w1g==}
|
||||
|
||||
'@types/estree@1.0.8':
|
||||
resolution: {integrity: sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==}
|
||||
|
||||
'@types/filesystem@0.0.36':
|
||||
resolution: {integrity: sha512-vPDXOZuannb9FZdxgHnqSwAG/jvdGM8Wq+6N4D/d80z+D4HWH+bItqsZaVRQykAn6WEVeEkLm2oQigyHtgb0RA==}
|
||||
|
||||
'@types/filewriter@0.0.33':
|
||||
resolution: {integrity: sha512-xFU8ZXTw4gd358lb2jw25nxY9QAgqn2+bKKjKOYfNCzN4DKCFetK7sPtrlpg66Ywe3vWY9FNxprZawAh9wfJ3g==}
|
||||
|
||||
'@types/har-format@1.2.16':
|
||||
resolution: {integrity: sha512-fluxdy7ryD3MV6h8pTfTYpy/xQzCFC7m89nOH9y94cNqJ1mDIDPut7MnRHI3F6qRmh/cT2fUjG1MLdCNb4hE9A==}
|
||||
|
||||
'@types/http-cache-semantics@4.0.4':
|
||||
resolution: {integrity: sha512-1m0bIFVc7eJWyve9S0RnuRgcQqF/Xd5QsUZAZeQFr1Q3/p9JWoQQEqmVy+DPTNpGXwhgIetAoYF8JSc33q29QA==}
|
||||
|
||||
@@ -1554,6 +1601,9 @@ packages:
|
||||
'@types/react@18.3.27':
|
||||
resolution: {integrity: sha512-cisd7gxkzjBKU2GgdYrTdtQx1SORymWyaAFhaxQPK9bYO9ot3Y5OikQRvY0VYQtvwjeQnizCINJAenh/V7MK2w==}
|
||||
|
||||
'@types/turndown@5.0.6':
|
||||
resolution: {integrity: sha512-ru00MoyeeouE5BX4gRL+6m/BsDfbRayOskWqUvh7CLGW+UXxHQItqALa38kKnOiZPqJrtzJUgAC2+F0rL1S4Pg==}
|
||||
|
||||
'@types/ws@8.18.1':
|
||||
resolution: {integrity: sha512-ThVF6DCVhA8kUGy+aazFQ4kXQ7E1Ty7A3ypFOe0IcJV8O/M511G99AW24irKrW56Wt44yG9+ij8FaqoBGkuBXg==}
|
||||
|
||||
@@ -3547,8 +3597,8 @@ packages:
|
||||
stackback@0.0.2:
|
||||
resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
|
||||
|
||||
stage-js@1.0.0-alpha.17:
|
||||
resolution: {integrity: sha512-AzlMO+t51v6cFvKZ+Oe9DJnL1OXEH5s9bEy6di5aOrUpcP7PCzI/wIeXF0u3zg0L89gwnceoKxrLId0ZpYnNXw==}
|
||||
stage-js@1.0.1:
|
||||
resolution: {integrity: sha512-cz14aPp/wY0s3bkb/B93BPP5ZAEhgBbRmAT3CCDqert8eCAqIpQ0RB2zpK8Ksxf+Pisl5oTzvPHtL4CVzzeHcw==}
|
||||
engines: {node: '>=18.0'}
|
||||
|
||||
statuses@2.0.2:
|
||||
@@ -3766,6 +3816,9 @@ packages:
|
||||
resolution: {integrity: sha512-7Imdmg37joOloTnj+DPrab9hIaQcDdJ5RwSzcauo/wMOSAgO+A/I/8b3hsGGs6PWQz70m/jkPgdqWsfNKtwwDQ==}
|
||||
hasBin: true
|
||||
|
||||
turndown@7.2.2:
|
||||
resolution: {integrity: sha512-1F7db8BiExOKxjSMU2b7if62D/XOyQyZbPKq/nUwopfgnHlqXHqQ0lvfUTeUIr1lZJzOPFn43dODyMSIfvWRKQ==}
|
||||
|
||||
typanion@3.14.0:
|
||||
resolution: {integrity: sha512-ZW/lVMRabETuYCd9O9ZvMhAh8GslSqaUjxmK/JLPCh6l73CvLBiuXswj/+7LdnWOgYsQ130FqLzFz5aGT4I3Ug==}
|
||||
|
||||
@@ -4693,6 +4746,8 @@ snapshots:
|
||||
- encoding
|
||||
- supports-color
|
||||
|
||||
'@mixmark-io/domino@2.2.0': {}
|
||||
|
||||
'@modelcontextprotocol/sdk@1.25.3(hono@4.11.7)(zod@3.25.76)':
|
||||
dependencies:
|
||||
'@hono/node-server': 1.19.9(hono@4.11.7)
|
||||
@@ -4715,6 +4770,8 @@ snapshots:
|
||||
- hono
|
||||
- supports-color
|
||||
|
||||
'@mozilla/readability@0.6.0': {}
|
||||
|
||||
'@noble/ciphers@1.3.0': {}
|
||||
|
||||
'@noble/curves@1.9.7':
|
||||
@@ -4954,7 +5011,7 @@ snapshots:
|
||||
'@opentui/core-win32-x64@0.1.75':
|
||||
optional: true
|
||||
|
||||
'@opentui/core@0.1.75(stage-js@1.0.0-alpha.17)(typescript@5.9.3)(web-tree-sitter@0.25.10)':
|
||||
'@opentui/core@0.1.75(stage-js@1.0.1)(typescript@5.9.3)(web-tree-sitter@0.25.10)':
|
||||
dependencies:
|
||||
bun-ffi-structs: 0.1.2(typescript@5.9.3)
|
||||
diff: 8.0.2
|
||||
@@ -4971,17 +5028,17 @@ snapshots:
|
||||
'@opentui/core-win32-arm64': 0.1.75
|
||||
'@opentui/core-win32-x64': 0.1.75
|
||||
bun-webgpu: 0.1.4
|
||||
planck: 1.4.2(stage-js@1.0.0-alpha.17)
|
||||
planck: 1.4.2(stage-js@1.0.1)
|
||||
three: 0.177.0
|
||||
transitivePeerDependencies:
|
||||
- stage-js
|
||||
- typescript
|
||||
|
||||
'@opentui/solid@0.1.75(solid-js@1.9.11)(stage-js@1.0.0-alpha.17)(typescript@5.9.3)(web-tree-sitter@0.25.10)':
|
||||
'@opentui/solid@0.1.75(solid-js@1.9.11)(stage-js@1.0.1)(typescript@5.9.3)(web-tree-sitter@0.25.10)':
|
||||
dependencies:
|
||||
'@babel/core': 7.28.0
|
||||
'@babel/preset-typescript': 7.27.1(@babel/core@7.28.0)
|
||||
'@opentui/core': 0.1.75(stage-js@1.0.0-alpha.17)(typescript@5.9.3)(web-tree-sitter@0.25.10)
|
||||
'@opentui/core': 0.1.75(stage-js@1.0.1)(typescript@5.9.3)(web-tree-sitter@0.25.10)
|
||||
babel-plugin-module-resolver: 5.0.2
|
||||
babel-preset-solid: 1.9.9(@babel/core@7.28.0)(solid-js@1.9.11)
|
||||
s-js: 0.4.9
|
||||
@@ -5147,8 +5204,21 @@ snapshots:
|
||||
dependencies:
|
||||
'@types/node': 22.19.7
|
||||
|
||||
'@types/chrome@0.0.280':
|
||||
dependencies:
|
||||
'@types/filesystem': 0.0.36
|
||||
'@types/har-format': 1.2.16
|
||||
|
||||
'@types/estree@1.0.8': {}
|
||||
|
||||
'@types/filesystem@0.0.36':
|
||||
dependencies:
|
||||
'@types/filewriter': 0.0.33
|
||||
|
||||
'@types/filewriter@0.0.33': {}
|
||||
|
||||
'@types/har-format@1.2.16': {}
|
||||
|
||||
'@types/http-cache-semantics@4.0.4': {}
|
||||
|
||||
'@types/long@4.0.2': {}
|
||||
@@ -5177,6 +5247,8 @@ snapshots:
|
||||
'@types/prop-types': 15.7.15
|
||||
csstype: 3.2.3
|
||||
|
||||
'@types/turndown@5.0.6': {}
|
||||
|
||||
'@types/ws@8.18.1':
|
||||
dependencies:
|
||||
'@types/node': 22.19.7
|
||||
@@ -7015,9 +7087,9 @@ snapshots:
|
||||
dependencies:
|
||||
find-up: 3.0.0
|
||||
|
||||
planck@1.4.2(stage-js@1.0.0-alpha.17):
|
||||
planck@1.4.2(stage-js@1.0.1):
|
||||
dependencies:
|
||||
stage-js: 1.0.0-alpha.17
|
||||
stage-js: 1.0.1
|
||||
optional: true
|
||||
|
||||
platform@1.3.6: {}
|
||||
@@ -7439,7 +7511,7 @@ snapshots:
|
||||
|
||||
stackback@0.0.2: {}
|
||||
|
||||
stage-js@1.0.0-alpha.17:
|
||||
stage-js@1.0.1:
|
||||
optional: true
|
||||
|
||||
statuses@2.0.2: {}
|
||||
@@ -7688,6 +7760,10 @@ snapshots:
|
||||
turbo-windows-64: 2.7.5
|
||||
turbo-windows-arm64: 2.7.5
|
||||
|
||||
turndown@7.2.2:
|
||||
dependencies:
|
||||
'@mixmark-io/domino': 2.2.0
|
||||
|
||||
typanion@3.14.0: {}
|
||||
|
||||
type-detect@4.1.0: {}
|
||||
|
||||
@@ -30,6 +30,16 @@
|
||||
},
|
||||
"metadata": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"skillkit-tags": {
|
||||
"type": "string",
|
||||
"description": "Comma-separated categorization tags (strict mode preferred location)"
|
||||
},
|
||||
"skillkit-agents": {
|
||||
"type": "string",
|
||||
"description": "Comma-separated compatible agent list (strict mode preferred location)"
|
||||
}
|
||||
},
|
||||
"additionalProperties": { "type": "string" },
|
||||
"description": "Arbitrary key-value mapping for additional metadata."
|
||||
},
|
||||
@@ -54,7 +64,7 @@
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "string",
|
||||
"enum": ["claude-code", "codex", "cursor", "antigravity", "opencode", "gemini-cli", "universal"]
|
||||
"enum": ["claude-code", "codex", "cursor", "antigravity", "opencode", "gemini-cli", "amp", "clawdbot", "droid", "github-copilot", "goose", "kilo", "kiro-cli", "roo", "trae", "windsurf", "universal", "cline", "codebuddy", "commandcode", "continue", "crush", "factory", "mcpjam", "mux", "neovate", "openhands", "pi", "qoder", "qwen", "vercel", "zencoder", "devin", "aider", "sourcegraph-cody", "amazon-q", "augment-code", "replit-agent", "bolt", "lovable", "tabby", "tabnine", "codegpt", "playcode-agent"]
|
||||
},
|
||||
"description": "Compatible AI agents (empty = all agents)"
|
||||
}
|
||||
|
||||