Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 6 additions & 4 deletions docs/fumadocs/content/docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -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
1 change: 1 addition & 0 deletions docs/fumadocs/content/docs/meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
"recommendations",
"primer",
"memory",
"methodology",
"mesh",
"messaging",
"workflows",
Expand Down
93 changes: 93 additions & 0 deletions docs/fumadocs/content/docs/methodology.mdx
Original file line number Diff line number Diff line change
@@ -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.
2 changes: 1 addition & 1 deletion docs/fumadocs/content/docs/rest-api.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ curl http://localhost:3737/health
```json
{
"status": "ok",
"version": "1.12.0",
"version": "1.19.2",
"skillCount": 15062,
"uptime": 3600
}
Expand Down
4 changes: 2 additions & 2 deletions docs/skillkit/components/Hero.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -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' },
Expand Down
7 changes: 5 additions & 2 deletions packages/tui/src/screens/Help.tsx
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟡 Hardcoded isLast index in right column is wrong after adding new 'Session' section

The PR added a new 'Session' section to the SHORTCUTS array (now 5 sections total), but the right-column isLast check at line 123 is still hardcoded to idx() === 1. Before this PR, SHORTCUTS.slice(2) yielded 2 sections (indices 0 and 1), so idx() === 1 correctly identified the last. Now SHORTCUTS.slice(2) yields 3 sections (indices 0, 1, 2), so the last section is at index 2. As a result, the spacer between "Team & Config" (index 1) and "Global" (index 2) is missing, and a spurious trailing spacer is rendered after "Global".

(Refers to line 123)

Open in Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

Original file line number Diff line number Diff line change
Expand Up @@ -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' },
Expand Down