# Skillable

> Use when you want to analyze tool call patterns across agent sessions, discover common workflows, suggest new skills, or identify what is already well-served.

- **Type:** Skill
- **Install:** `agentstack add skill-codesoda-skillable-skillable`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [codesoda](https://agentstack.voostack.com/s/codesoda)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [codesoda](https://github.com/codesoda)
- **Source:** https://github.com/codesoda/skillable/tree/main/skills/skillable

## Install

```sh
agentstack add skill-codesoda-skillable-skillable
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Analyze agent session transcripts to discover common tool call patterns, identify workflows that could become skills, and generate a structured report.

## Arguments

- `$ARGUMENTS` — Scope of analysis. Options:
  - (empty) — Analyze the current project only
  - `--all` — Analyze ALL projects
  - `--projects name1 name2 ...` — Analyze specific projects by name (matches directory names loosely)
  - `--days N` — Look back N days (default: 7)

## Workflow

### Step 0: Determine project scope

If no arguments are provided, present an interactive project picker.
Read the picker flow from docs/interactive-selection.md — it has the alerter checklist command, AskUserQuestion fallback, and time window prompts.

If `--all` or `--projects` was provided, skip the picker. If `--days` was provided, skip the time window picker.

### Step 1: Locate session transcripts

Scan all detected agents for session files. Read docs/agent-sessions.md for the full map of 12 supported agents, their session directories, and file formats (JSONL, JSON, or SQLite).

Check which agent directories exist, report discovered agents, and collect sessions from all of them.

### Step 2: Filter to time window

Only include sessions modified within the `--days` window (default 7).

### Step 3: Extract tool calls

Read docs/extraction.md for the grep patterns to pull tool_use blocks from JSONL and the command normalization table.

### Step 4: Compute statistics

- Overall tool usage: count invocations per tool type
- Top 20 Bash commands (normalized)
- Skill invocations by skill name
- Bigrams and trigrams of consecutive tool calls
- Longer sequences (4-6 calls) repeating 3+ times — strongest skill candidates

### Step 5: Identify workflow clusters

Classify sessions by workflow markers. Read docs/workflow-markers.md for the detection table mapping markers (investigation, commit, PR creation, CI monitoring, etc.) to their tool call signatures.

### Step 6: Generate the report

Read docs/report-format.md for the full 8-section report template covering overview, tool breakdown, top commands, skill usage, clusters, n-grams, skillable workflows, and already well-served patterns.

### Step 7: Offer to create skills

Ask me which discovered workflows to turn into skills. For each selected:

1. If a `/skill-creator` skill is available, use it. Otherwise create `~/.claude/skills/skill-name/SKILL.md` following the spec at https://agentskills.io/specification
2. Design the workflow based on observed tool call sequences

### Step 8: Save the report

Save to `docs/plans/skill-analysis-DATE.md` (project-scoped) or a temp file (cross-project).

## Tips

- Only count top-level tool calls, not subagent internals
- Treat each session file as independent (no cross-session deduplication)
- Scan `~/.claude/skills/`, `~/.agent/skills/`, and `~/.codex/skills/` for existing skills to populate the "Exists?" column
- After the report, offer to symlink any skills missing from one location into the others

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [codesoda](https://github.com/codesoda)
- **Source:** [codesoda/skillable](https://github.com/codesoda/skillable)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-codesoda-skillable-skillable
- Seller: https://agentstack.voostack.com/s/codesoda
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.