diff --git a/README.md b/README.md index 065ed9fb..da0ed60c 100644 --- a/README.md +++ b/README.md @@ -183,13 +183,13 @@ 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. +Save any webpage as a skill directly from your browser. 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. +The extension sends the page URL to the SkillKit API for server-side extraction with Turndown, 5-source weighted tag detection, and GitHub URL support. The resulting SKILL.md downloads automatically. Then run `skillkit install ~/Downloads/skillkit-skills/my-skill` to deploy to all agents. [Extension docs](https://agenstskills.com/docs/chrome-extension) diff --git a/apps/skillkit/package.json b/apps/skillkit/package.json index 19aa7ad7..9c570d47 100644 --- a/apps/skillkit/package.json +++ b/apps/skillkit/package.json @@ -1,6 +1,6 @@ { "name": "skillkit", - "version": "1.18.0", + "version": "1.19.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": { diff --git a/docs/fumadocs/content/docs/chrome-extension.mdx b/docs/fumadocs/content/docs/chrome-extension.mdx index 0f41d328..ad60d506 100644 --- a/docs/fumadocs/content/docs/chrome-extension.mdx +++ b/docs/fumadocs/content/docs/chrome-extension.mdx @@ -5,7 +5,7 @@ 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. +Save any webpage as a SKILL.md directly from your browser. ## Install @@ -33,14 +33,14 @@ Then load `packages/extension/dist/` as an unpacked extension. 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. +The extension sends the page URL to the SkillKit API, which extracts the content as markdown, generates tags using weighted 5-source analysis, and returns a complete SKILL.md. The file downloads 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 +- **Save page as Skill** — sends the URL to the API, downloads the result +- **Save selection as Skill** — builds the skill locally from selected text (no network request) ### Making Skills Available to Agents @@ -59,28 +59,31 @@ skillkit sync ## How It Works -The extension runs entirely in the browser: +``` +Extension → POST /api/save-skill { url } → Server pipeline → Download +``` -1. **Content script** extracts page content using [Turndown](https://github.com/mixmark-io/turndown) to convert HTML to clean markdown. It targets `
`, `
`, or `` and strips scripts, nav, footer, and iframes. +1. **Popup** reads the current tab's URL and title via `activeTab` permission. No content script injection needed. -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 +2. **Background service worker** sends the URL to `agenstskills.com/api/save-skill`: + - Server fetches the page and converts HTML to markdown via Turndown + - GitHub URLs are auto-converted to raw content + - Tags are detected from 5 weighted sources (URL segments, headings, code blocks, keywords, language) + - Returns a complete SKILL.md with YAML frontmatter -3. **No server required** — the `POST /save` API endpoint exists for CLI users (`skillkit save`), but the extension works independently. +3. **Download** — the service worker creates a blob and saves via `chrome.downloads` API. + +4. **Selection saves** work entirely offline — Chrome natively provides `selectionText` via the context menu API, so the skill is built locally with no server round-trip. ## Permissions | Permission | Why | |-----------|-----| | `contextMenus` | Right-click "Save as Skill" menu items | -| `activeTab` | Access current page URL and title | -| `storage` | Persist extension preferences | +| `activeTab` | Access current page URL and title on click | | `downloads` | Save SKILL.md files to disk | -No `host_permissions` needed. The extension never sends data to any server. +No `host_permissions` or `scripting` permissions needed. Only the page URL is sent to the server — no page content, browsing history, or personal data. ## Generated SKILL.md Format @@ -94,7 +97,7 @@ tags: - testing metadata: source: https://example.com/react-performance - savedAt: 2026-02-10T09:00:00.000Z + savedAt: 2026-02-14T09:00:00.000Z --- # React Performance Tips @@ -111,9 +114,8 @@ 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) +- `background.global.js` — Service worker (~4KB) +- `popup.global.js` — Popup UI logic (~2KB) - `popup.html` + `popup.css` — Monochromatic UI - `manifest.json` — Chrome Manifest V3 - `icons/` — 16/48/128px PNG icons diff --git a/docs/fumadocs/package.json b/docs/fumadocs/package.json index 496497c6..c507c0d1 100644 --- a/docs/fumadocs/package.json +++ b/docs/fumadocs/package.json @@ -1,6 +1,6 @@ { "name": "skillkit-docs", - "version": "1.18.0", + "version": "1.19.0", "private": true, "scripts": { "build": "next build", diff --git a/docs/skillkit/package.json b/docs/skillkit/package.json index bad294c2..ace076ad 100644 --- a/docs/skillkit/package.json +++ b/docs/skillkit/package.json @@ -1,7 +1,7 @@ { "name": "skillkit", "private": true, - "version": "1.18.0", + "version": "1.19.0", "type": "module", "scripts": { "dev": "vite", diff --git a/package.json b/package.json index b66e1af5..ee6100ab 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "skillkit-monorepo", - "version": "1.18.0", + "version": "1.19.0", "private": true, "description": "The package manager for AI agent skills — install, translate, share across 32 coding agents", "type": "module", diff --git a/packages/agents/package.json b/packages/agents/package.json index 6052260f..4b37ede1 100644 --- a/packages/agents/package.json +++ b/packages/agents/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/agents", - "version": "1.18.0", + "version": "1.19.0", "description": "Agent adapters for SkillKit - supports 32 AI coding agents", "type": "module", "main": "./dist/index.js", diff --git a/packages/api/package.json b/packages/api/package.json index a7885e10..02a21ead 100644 --- a/packages/api/package.json +++ b/packages/api/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/api", - "version": "1.18.0", + "version": "1.19.0", "description": "REST API server for SkillKit skill discovery", "type": "module", "main": "./dist/index.js", diff --git a/packages/cli/package.json b/packages/cli/package.json index 53f54456..82405b58 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/cli", - "version": "1.18.0", + "version": "1.19.0", "description": "CLI commands for SkillKit", "type": "module", "main": "./dist/index.js", diff --git a/packages/core/package.json b/packages/core/package.json index dae39e95..473913b4 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/core", - "version": "1.18.0", + "version": "1.19.0", "description": "Core functionality for SkillKit - skill discovery, parsing, and translation", "type": "module", "main": "./dist/index.js", diff --git a/packages/extension/package.json b/packages/extension/package.json index 05b6ab43..3202dea9 100644 --- a/packages/extension/package.json +++ b/packages/extension/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/extension", - "version": "1.18.0", + "version": "1.19.0", "private": true, "description": "Chrome extension to save any webpage as an AI agent skill", "type": "module", diff --git a/packages/extension/src/manifest.json b/packages/extension/src/manifest.json index 5b04f4b9..c060cd6e 100644 --- a/packages/extension/src/manifest.json +++ b/packages/extension/src/manifest.json @@ -1,7 +1,7 @@ { "manifest_version": 3, "name": "SkillKit - Save as Skill", - "version": "1.18.0", + "version": "1.19.0", "description": "Save any webpage as an AI agent skill — instantly available across 44 agents", "permissions": ["contextMenus", "activeTab", "downloads"], "background": { diff --git a/packages/mcp-memory/package.json b/packages/mcp-memory/package.json index b85baf34..8b258708 100644 --- a/packages/mcp-memory/package.json +++ b/packages/mcp-memory/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/mcp-memory", - "version": "1.18.0", + "version": "1.19.0", "description": "MCP (Model Context Protocol) server for SkillKit persistent memory", "type": "module", "main": "./dist/index.js", diff --git a/packages/mcp/package.json b/packages/mcp/package.json index 4ac36fcc..8d75149d 100644 --- a/packages/mcp/package.json +++ b/packages/mcp/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/mcp", - "version": "1.18.0", + "version": "1.19.0", "description": "MCP server for SkillKit skill discovery — agent-native skill search", "type": "module", "main": "./dist/index.js", diff --git a/packages/memory/package.json b/packages/memory/package.json index c666cb5e..7e606ab9 100644 --- a/packages/memory/package.json +++ b/packages/memory/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/memory", - "version": "1.18.0", + "version": "1.19.0", "description": "CozoDB-backed semantic memory with embeddings for SkillKit", "type": "module", "main": "./dist/index.js", diff --git a/packages/mesh/package.json b/packages/mesh/package.json index 49ecdb19..3bf831ed 100644 --- a/packages/mesh/package.json +++ b/packages/mesh/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/mesh", - "version": "1.18.0", + "version": "1.19.0", "description": "Peer mesh network for multi-machine agent distribution", "type": "module", "main": "./dist/index.js", diff --git a/packages/messaging/package.json b/packages/messaging/package.json index fc7daa70..0ac7dcd5 100644 --- a/packages/messaging/package.json +++ b/packages/messaging/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/messaging", - "version": "1.18.0", + "version": "1.19.0", "description": "Inter-agent messaging system for SkillKit", "type": "module", "main": "./dist/index.js", diff --git a/packages/resources/package.json b/packages/resources/package.json index ba5ee902..9d25f616 100644 --- a/packages/resources/package.json +++ b/packages/resources/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/resources", - "version": "1.18.0", + "version": "1.19.0", "description": "Bundled resources for SkillKit - agents, commands, profiles, guidelines, and hooks", "type": "module", "main": "./dist/index.js", diff --git a/packages/tui/package.json b/packages/tui/package.json index 238747cb..7d777996 100644 --- a/packages/tui/package.json +++ b/packages/tui/package.json @@ -1,6 +1,6 @@ { "name": "@skillkit/tui", - "version": "1.18.0", + "version": "1.19.0", "description": "Unified Terminal UI for SkillKit - Built on OpenTUI", "type": "module", "main": "./dist/index.js",