mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-18 18:04:26 +00:00
fix: update docs, TUI help, and website for v1.19.2 gaps (#82)
- docs/index.mdx: version v1.18.0 → v1.19.2, add skills.sh install source, add methodology packs to next steps - docs/rest-api.mdx: health check example version 1.12.0 → 1.19.2 - docs/methodology.mdx: new page documenting 5 packs with 14 skills - docs/meta.json: add methodology to page ordering - Hero.tsx: show skills.sh install in terminal animation - Help.tsx: fix shortcut conflicts — add Session section (l=Timeline, v=Lineage, f=Handoff), remove stale f=Find/v=Validate mappings
This commit is contained in:
@@ -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
|
||||
|
||||
@@ -14,6 +14,7 @@
|
||||
"recommendations",
|
||||
"primer",
|
||||
"memory",
|
||||
"methodology",
|
||||
"mesh",
|
||||
"messaging",
|
||||
"workflows",
|
||||
|
||||
@@ -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.
|
||||
@@ -158,7 +158,7 @@ curl http://localhost:3737/health
|
||||
```json
|
||||
{
|
||||
"status": "ok",
|
||||
"version": "1.12.0",
|
||||
"version": "1.19.2",
|
||||
"skillCount": 15062,
|
||||
"uptime": 3600
|
||||
}
|
||||
|
||||
@@ -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' },
|
||||
|
||||
@@ -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' },
|
||||
|
||||
Reference in New Issue
Block a user