# Refs

> Sync and search local reference repositories (curated awesome-* lists) to support planning/design decisions.

- Skill: `majiayu000/refs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/refs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/refs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/refs

---


# /sdlc:refs - Local Reference Repos (Awesome Lists)

Use this skill to keep curated `awesome-*` repos available locally so other SDLC skills and agents can `Read`/`Grep` them during planning and design.

## Sync / Update

```bash
${CLAUDE_PLUGIN_ROOT}/scripts/awesome/sync.sh
```

This also writes a lock file (commit SHAs per repo):
- `${CLAUDE_PLUGIN_ROOT}/references/awesome/LOCK.json`

## How To Search

```bash
rg -n "observability" "${CLAUDE_PLUGIN_ROOT}/references/awesome/repos"
rg -n "threat model" "${CLAUDE_PLUGIN_ROOT}/references/awesome/repos"
rg -n "architecture decision record|ADR" "${CLAUDE_PLUGIN_ROOT}/references/awesome/repos"
```

## Optional: Build/Search A Catalog

This builds a small SQLite catalog (FTS) from the local README files:

```bash
${CLAUDE_PLUGIN_ROOT}/scripts/awesome/catalog.py build
${CLAUDE_PLUGIN_ROOT}/scripts/awesome/catalog.py search "OpenTelemetry"
${CLAUDE_PLUGIN_ROOT}/scripts/awesome/catalog.py search "\"feature flags\"" --limit 10
${CLAUDE_PLUGIN_ROOT}/scripts/awesome/catalog.py search "OpenTelemetry" --no-social
```

## Where The Seed List Lives

- `${CLAUDE_PLUGIN_ROOT}/references/awesome/seeds.tsv`