# Skills Index Snippets

> Create and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the correct ai-skills skills (including compressed Vercel-style indexes).

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

## Install

```sh
agentstack add skill-pnp-ai-skills-skills-index-snippets
```

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

## About

# Maintaining Skill Index Snippets (AGENTS.md / CLAUDE.md)

## When to Use This Skill

Use this skill when:
- Adding, removing, or renaming any skills in this repository
- Updating `.claude-plugin/plugin.json`
- Creating copy/paste snippets for downstream repositories (OpenCode, Claude Code, etc.)
- You want a compact, always-on index that improves skill utilization

## Goal

Make skills easy for coding assistants to use by removing the decision point.

Instead of hoping an assistant will "remember" to invoke a skill, provide a small router snippet inside `AGENTS.md` / `CLAUDE.md` that:

1) Provides a task->skill routing index
2) Keeps skill usage consistent across projects

## Source of Truth

- Registry: `.claude-plugin/plugin.json`
  - Skills are listed as directories (each contains `SKILL.md`)
- Skill IDs: the `name:` field in each `SKILL.md` frontmatter

When writing snippets for downstream repos, always reference skills by their IDs (frontmatter `name`), not by local filesystem paths.

## Minimal Snippet Template (Readable)

Use this in target repos to route common tasks:

```markdown
# Agent Guidance: ai-skills

Workflow: skim repo patterns -> use spfx-best-practices by name -> implement smallest-change -> note conflicts.

Routing (invoke by name)
- SPFx: spfx-best-practices
```

## Compressed Snippet Template (Vercel-style)

Use this when you want maximum density (small context footprint):

```markdown
[ai-skills]|flow:{skim repo patterns -> use spfx-best-practices by name -> implement smallest-change -> note conflicts}
|route:
|spfx:{spfx-best-practices}
```

### Regenerating the README block

If the README contains the markers below, the generator can update it automatically:

```

...compressed snippet...

```

Run:

```bash
./scripts/generate-skill-index-snippets.sh --update-readme
```

## How to Update Snippets After Skill Changes

1. Update `.claude-plugin/plugin.json` to include/remove skills.
2. Ensure each skill has correct frontmatter `name:` (used by OpenCode and others).
3. Run `./scripts/validate-marketplace.sh`.
4. Update your snippet routing lists:
   - Add new skills to the right category
   - Remove deleted skills
   - Keep names exactly matching frontmatter IDs
5. If you maintain a downstream `AGENTS.md`/`CLAUDE.md` snippet, regenerate it and re-copy into dependent repos.

## Recommended Categories

These are snippet categories (not necessarily repository folder structure):

- SPFx

Keep the snippet small; it should be a router, not documentation.

## Source & license

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

- **Author:** [pnp](https://github.com/pnp)
- **Source:** [pnp/ai-skills](https://github.com/pnp/ai-skills)
- **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-pnp-ai-skills-skills-index-snippets
- Seller: https://agentstack.voostack.com/s/pnp
- 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%.