# Insight Skill Gap

> >

- **Type:** Skill
- **Install:** `agentstack add skill-allemaar-open-skills-insight-skill-gap`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [allemaar](https://agentstack.voostack.com/s/allemaar)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [allemaar](https://github.com/allemaar)
- **Source:** https://github.com/allemaar/open-skills/tree/main/skills/insight-skill-gap
- **Website:** https://allemaar.com

## Install

```sh
agentstack add skill-allemaar-open-skills-insight-skill-gap
```

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

## About

# /skill-gap

Identify gaps in the skill library based on recent implementation work — propose new skills or updates to existing ones.

> **Structured execution spec:** [`protocol.yon`](protocol.yon). Read it for the canonical rules and step sequence; this file is explanation. The two must stay in sync — if you edit one, update the other and refresh the `@STAMP` date.

> **Skill Discovery Protocol — ensures reusable patterns don't stay buried in implementation code.**

## Phase 1 — Recent Work Scan

1. **Gather recent context** — conversation history, changed files, new patterns introduced. Summarize: what was built, which libraries/frameworks were used, what novel patterns emerged.
2. **Load skill index** — read the current skill index to know what already exists before analyzing gaps.

## Phase 2 — Gap Analysis

Cross-reference patterns from Phase 1 against the skill index. Classify each pattern:

- **(A) Skill exists and covers it** — no action
- **(B) Skill exists but is incomplete** — propose update; specify which sections are missing or outdated
- **(C) No skill exists** — evaluate against new-skill criteria below

**Criteria for a new skill:**

- Pattern is reusable (used 2+ times, or clearly will be)
- Pattern involves non-obvious decisions or gotchas
- Pattern spans multiple files or concepts

**Gate:** gap analysis must be documented before proceeding.

## Phase 3 — Skill Proposals

For each gap, draft a skill specification:

- **Skill name** — domain-prefix convention (e.g., `drizzle-*`, `nextjs16-*`)
- **Skill family** — domain prefix
- **Prerequisites** — what the user needs to know first
- **Complexity estimate** — how large/involved the skill content will be
- **Key sections to cover** — what the skill should teach

Check `new-skill-creator` for template requirements before drafting. Present proposals to the user and wait for approval before proceeding.

## Phase 4 — Execution (only if approved)

Create approved skills via `/new-skill-creator`. For updates, apply targeted edits to the relevant sections.

## Rules

- MUST verify no existing skill covers the same domain before proposing a new one.
- MUST follow the domain-prefix naming convention.
- MUST specify which sections are missing or outdated when proposing updates.
- MUST check `new-skill-creator` for template requirements before proposing new skills.
- MUST NOT propose skills for one-off patterns with no reuse potential.
- SHOULD recommend immediate creation (not deferral) when reuse potential is HIGH.

## Next Steps

- `/new-skill-creator` — to build approved skills

> **Human output.** This skill's handler-facing output obeys the human-output
> contract (`human-output/SKILL.md`).

> **Next skills.** On completion, run the Next Skills protocol (`next-skills/SKILL.md`): surface the `next-skills` recommendations from front-matter for the caller to pick. Offer only — never auto-invoke.

> **Self-improvement.** On completion, run the Self-Improvement Protocol (`self-improve/SKILL.md`): if this run surfaced a concrete, blocking-or-recurring weakness in this skill, propose a specific fix for the handler to approve. Conservative — silent otherwise. Never auto-apply.

## Source & license

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

- **Author:** [allemaar](https://github.com/allemaar)
- **Source:** [allemaar/open-skills](https://github.com/allemaar/open-skills)
- **License:** Apache-2.0
- **Homepage:** https://allemaar.com

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-allemaar-open-skills-insight-skill-gap
- Seller: https://agentstack.voostack.com/s/allemaar
- 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%.