# Skill Index Updater

Add GitHub skill repos to the ASM index: clone, audit, eval, regenerate index, rebuild...

- Repository: https://github.com/luongnv89/asm (962 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add luongnv89/asm --skill skill-index-updater -g -a claude-code -y`
Codex: `npx skills add luongnv89/asm --skill skill-index-updater -g -a codex -y`
Cursor: `npx skills add luongnv89/asm --skill skill-index-updater -g -a cursor -y`
Gemini CLI: `npx skills add luongnv89/asm --skill skill-index-updater -g -a gemini-cli -y`

## Description

Add GitHub skill repos to the ASM index: clone, audit, eval, regenerate index, rebuild catalog, open PR. Use when given GitHub URLs to onboard. Don't use for refreshing indexed repos (refresh-index), improving skills (skill-creator), or install.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Skill Index Updater

You are adding new skill repository sources to the ASM (Agent Skill Manager) curated index. This is the pipeline that powers the skill catalog at https://luongnv.com/asm/, every repo you add here becomes discoverable and installable by thousands of users.

## Example

```
User: add github.com/anthropics/skills to the index
Skill output:
  Step 1: Parsed 1 URL → anthropics/skills (NEW)
  Step 2: Discovered 14 SKILL.md files
  Step 3: Audit 13 OK / 1 WARN, eval scores 71, 94
  Step 6, 8: data/skill-index-resources.json + data/skill-index/anthropics_skills.json updated, catalog rebuilt
  Step 10: PR #312 opened, feat(index): add anthropics/skills (14 skills)
```

## Repo Sync Before Edits (mandatory)

Before modifying any files, pull the latest remote branch:

```bash
branch="$(git rev-parse --abbrev-ref HEAD)"
git fetch origin
git pull --rebase origin "$branch"
```

If the working tree is dirty: stash, sync, then pop. If `origin` is missing or conflicts occur: stop and ask the user before continuing.

## Prerequisites

Check each before Step 1. If one fails, stop and name it.

- `node` (>= 22), `jq`, and `git` on PATH; `npm install` done in the repo, so `npx tsx` resolves
- `asm` on PATH, the Step 3 workers run `asm eval`
- `gh auth status` succeeds, Step 10 opens the PR
- `git status --porcelain -- website/ data/` prints nothing. Step 8 restores the tracked `website/` files and `data/repo-stars.json` that `build-catalog` rewrites, which is safe only from a clean start.

## Input

The user provides one or more GitHub repository URLs: `https://github.com/owner/repo`, `github.com/owner/repo`, `github:owner/repo`, or `owner/repo`. Normalize each to `owner` and `repo`.

## Pipeline

Follow these steps in order. Each step has a verification check, do not proceed to the next step if verification fails.

The rest: https://github.com/luongnv89/asm/blob/HEAD/skills/skill-index-updater/SKILL.md