diff --git a/docs/fumadocs/content/docs/index.mdx b/docs/fumadocs/content/docs/index.mdx index 818781e6..9f613eb0 100644 --- a/docs/fumadocs/content/docs/index.mdx +++ b/docs/fumadocs/content/docs/index.mdx @@ -31,9 +31,10 @@ Four commands. Your agents now have skills for PDF processing, code review, and ### Install skills from anywhere ```bash -skillkit install anthropics/skills # GitHub -skillkit install gitlab:team/skills # GitLab -skillkit install ./my-local-skills # Local +skillkit install anthropics/skills # GitHub +skillkit install skills.sh/owner/repo/skill # skills.sh registry +skillkit install gitlab:team/skills # GitLab +skillkit install ./my-local-skills # Local ``` ### Translate between agents @@ -167,10 +168,11 @@ Team members run `skillkit manifest install` and they're in sync. - [Installation](/docs/installation) — Install and configure - [Quick Start](/docs/quickstart) — First project setup +- [Methodology Packs](/docs/methodology) — Debugging, testing, planning skills - [Security Scanner](/docs/security) — Threat detection for skills - [Commands](/docs/commands) — Full CLI reference - [REST API](/docs/rest-api) — Runtime discovery server - [MCP Server](/docs/mcp-server) — Agent-native discovery - [Python Client](/docs/python-client) — Python SDK -**Current version:** v1.18.0 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0 +**Current version:** v1.19.2 | [npm](https://www.npmjs.com/package/skillkit) | [GitHub](https://github.com/rohitg00/skillkit) | Apache-2.0 diff --git a/docs/fumadocs/content/docs/meta.json b/docs/fumadocs/content/docs/meta.json index d0c02b13..d5a60a2c 100644 --- a/docs/fumadocs/content/docs/meta.json +++ b/docs/fumadocs/content/docs/meta.json @@ -14,6 +14,7 @@ "recommendations", "primer", "memory", + "methodology", "mesh", "messaging", "workflows", diff --git a/docs/fumadocs/content/docs/methodology.mdx b/docs/fumadocs/content/docs/methodology.mdx new file mode 100644 index 00000000..6c99a9d2 --- /dev/null +++ b/docs/fumadocs/content/docs/methodology.mdx @@ -0,0 +1,93 @@ +--- +title: Methodology Packs +description: Curated skill packs for debugging, testing, planning, and collaboration +--- + +# Methodology Packs + +Methodology packs are curated collections of skills that guide AI agents through structured workflows. Each pack bundles related skills around a domain — debugging, testing, planning, or collaboration. + +## Available Packs + +| Pack | Skills | Description | +|------|--------|-------------| +| **debugging** | root-cause-analysis, trace-and-isolate, hypothesis-testing | Systematic bug investigation | +| **testing** | red-green-refactor, test-patterns, anti-patterns | Test-driven development | +| **planning** | design-first, task-decomposition, verification-gates | Design and decomposition | +| **collaboration** | structured-review, parallel-investigation, handoff-protocols | Code review and handoffs | +| **meta** | skill-authoring | Writing effective skills | + +## Commands + +```bash +skillkit methodology list # List available packs +skillkit methodology install debugging # Install a pack +skillkit methodology apply testing # Apply pack to current project +skillkit methodology validate planning # Validate pack skills +skillkit methodology load collaboration # Load pack into agent context +``` + +## Pack Structure + +Each pack lives under `packages/core/src/methodology/packs/` with this structure: + +``` +packs/ + debugging/ + pack.json # Pack manifest (name, skills, tags) + root-cause-analysis/ + SKILL.md # Skill content + trace-and-isolate/ + SKILL.md + hypothesis-testing/ + SKILL.md +``` + +## Skills Reference + +### Debugging + +- **root-cause-analysis** — Five Whys method, structured investigation phases, evidence collection, causal chain verification +- **trace-and-isolate** — Binary search debugging, git bisect, strategic logging, component isolation, minimal reproduction +- **hypothesis-testing** — Scientific method for debugging: observe, hypothesize, predict, test, conclude + +### Testing + +- **red-green-refactor** — Write a failing test, make it pass with minimal code, then refactor while green +- **test-patterns** — AAA, Given-When-Then, Test Data Builders, Object Mother, parameterized tests, fixtures, spies +- **anti-patterns** — Flaky tests, over-mocking, brittle assertions, test interdependency, hidden logic + +### Planning + +- **design-first** — Technical design documents before code: architecture, data models, API definitions, trade-off analysis +- **task-decomposition** — Vertical slicing, horizontal layering, workflow and component decomposition +- **verification-gates** — Validation checkpoints between phases with checklists and approval criteria + +### Collaboration + +- **structured-review** — Five-stage code review: requirements, correctness, quality, testing, security +- **parallel-investigation** — Coordinate multiple investigation threads with sync points and convergence decisions +- **handoff-protocols** — Structured work transitions: planned, unplanned, and partial handoffs + +### Meta + +- **skill-authoring** — Guidelines for writing SKILL.md files: frontmatter, triggers, directive language, content patterns + +## Using with Agents + +Once installed, methodology skills activate automatically based on trigger phrases. For example: + +``` +You: "I need to debug this failing API endpoint" +Agent: [Activates root-cause-analysis skill] + +You: "Let's write tests first for this feature" +Agent: [Activates red-green-refactor skill] + +You: "Break down this feature into tasks" +Agent: [Activates task-decomposition skill] +``` + +## TUI Integration + +Access methodology packs from the TUI by pressing `o` (Methodology screen). Browse, install, and apply packs interactively. diff --git a/docs/fumadocs/content/docs/rest-api.mdx b/docs/fumadocs/content/docs/rest-api.mdx index 4e6a7365..2232f47f 100644 --- a/docs/fumadocs/content/docs/rest-api.mdx +++ b/docs/fumadocs/content/docs/rest-api.mdx @@ -158,7 +158,7 @@ curl http://localhost:3737/health ```json { "status": "ok", - "version": "1.12.0", + "version": "1.19.2", "skillCount": 15062, "uptime": 3600 } diff --git a/docs/skillkit/components/Hero.tsx b/docs/skillkit/components/Hero.tsx index 1bc8b05b..8bfbd7b8 100644 --- a/docs/skillkit/components/Hero.tsx +++ b/docs/skillkit/components/Hero.tsx @@ -24,8 +24,8 @@ const TERMINAL_LINES: TerminalLine[] = [ { type: 'out', text: '→ Fetched from github.com/anthropics/skills' }, { type: 'out', text: '→ Translated to 44 agent formats' }, { type: 'out', text: '→ Scanned: 0 issues found' }, - { type: 'cmd', text: 'skillkit install vercel-labs/agent-skills' }, - { type: 'out', text: '→ Installed 12 skills from Vercel' }, + { type: 'cmd', text: 'skillkit install skills.sh/vercel/agent-skills' }, + { type: 'out', text: '→ Installed 12 skills from skills.sh' }, { type: 'cmd', text: 'skillkit translate --all --to cursor' }, { type: 'out', text: '→ 26 skills → .cursor/skills/' }, { type: 'cmd', text: 'skillkit recommend' }, diff --git a/packages/tui/src/screens/Help.tsx b/packages/tui/src/screens/Help.tsx index a0dfd412..56ad0909 100644 --- a/packages/tui/src/screens/Help.tsx +++ b/packages/tui/src/screens/Help.tsx @@ -17,17 +17,20 @@ const SHORTCUTS = [ { key: 'r', desc: 'Recommendations' }, { key: 'i', desc: 'Installed skills' }, { key: 's', desc: 'Sync settings' }, - { key: 'f', desc: 'Find skills' }, ]}, { section: 'Actions', items: [ { key: 't', desc: 'Translate skills' }, { key: 'w', desc: 'Workflows' }, { key: 'x', desc: 'Execute' }, { key: 'n', desc: 'Plan' }, - { key: 'v', desc: 'Validate' }, { key: 'u', desc: 'Publish' }, { key: 'z', desc: 'Security scan' }, ]}, + { section: 'Session', items: [ + { key: 'l', desc: 'Timeline' }, + { key: 'v', desc: 'Lineage' }, + { key: 'f', desc: 'Handoff' }, + ]}, { section: 'Team & Config', items: [ { key: 'a', desc: 'Team settings' }, { key: 'c', desc: 'Context' },