.claude/skills/setup/SKILL.md
First-time setup for the llm-wiki system. Checks tools, skills, and Obsidian. Use when setting up llm-wiki on a new machine.
npx skillsauth add RonanCodes/llm-wiki setupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
First-time bootstrap. Checks your environment and guides you through setup.
/setup
Read tools.json and check each required tool:
git --version 2>/dev/null || echo "MISSING: git — brew install git"
node --version 2>/dev/null || echo "MISSING: node — brew install node"
claude --version 2>/dev/null || echo "MISSING: claude — npm i -g @anthropic-ai/claude-code"
Offer to install any missing tools.
From tools.json, check optional tools (these lazy-install on first use):
which yt-dlp 2>/dev/null && echo "✓ yt-dlp" || echo "→ yt-dlp: installs on first YouTube ingest"
which pdftotext 2>/dev/null && echo "✓ poppler" || echo "→ poppler: installs on first PDF ingest"
which pandoc 2>/dev/null && echo "✓ pandoc" || echo "→ pandoc: installs on first Office doc ingest"
which qmd 2>/dev/null && echo "✓ qmd" || echo "→ qmd: installs when wiki exceeds ~200 pages"
Verify skills exist in .claude/skills/:
ls .claude/skills/ | wc -l
Report count and list any expected skills that are missing.
This project uses shared skills (ralph, frontend-design, create-skill, doc-standards) from a separate repo.
Check if the shared skills are available (via ~/.claude/skills/ or .claude/skills/):
If not found, offer the user these options:
Option A: Install globally via npx (recommended)
npx skills add RonanCodes/ronan-skills/src/ralph -g
npx skills add RonanCodes/ronan-skills/src/frontend-design -g
npx skills add RonanCodes/ronan-skills/src/create-skill -g
npx skills add RonanCodes/ronan-skills/src/doc-standards -g
Option B: Install into this project only
npx skills add RonanCodes/ronan-skills/src/ralph
npx skills add RonanCodes/ronan-skills/src/frontend-design
npx skills add RonanCodes/ronan-skills/src/create-skill
npx skills add RonanCodes/ronan-skills/src/doc-standards
Option C: Clone + symlink (stays up to date)
git clone https://github.com/RonanCodes/ronan-skills.git <their-path>/ronan-skillsln -s <their-path>/ronan-skills/src/<name> ~/.claude/skills/<name>[ -d "/Applications/Obsidian.app" ] && echo "✓ Obsidian" || echo "→ Obsidian: download from https://obsidian.md"
[ -d ".private" ] && echo "✓ .private/" || echo "→ No .private/ (optional — for private skills, add .local to skill name to auto-gitignore)"
═══════════════════════════════════════
LLM Wiki — Setup Report
═══════════════════════════════════════
Required tools: 3/3 installed
Optional tools: 2/5 installed (rest auto-install on use)
Bundled skills: 22 present
Shared skills: installed via marketplace
Obsidian: installed
Private overlay: not configured
Next steps:
1. Create a vault: /vault-create my-research --domain ai-research
2. Open in Obsidian: Open folder → vaults/llm-wiki-my-research
3. Ingest a source: /ingest <url> --vault llm-wiki-my-research
═══════════════════════════════════════
Skills with .local in the name are gitignored automatically:
.claude/skills/my-company-workflow.local/SKILL.md — gitignored.claude/skills/ingest/SKILL.md — committed (bundled)This lets you add private skills to the project without them leaking to the public repo.
data-ai
Extract transcript from a YouTube video as clean readable text. Use when user shares a youtube.com or youtu.be link and wants the transcript, content summary, or to read what was said.
development
Page type templates and frontmatter conventions for LLM Wiki pages. Reference skill loaded by ingest, query, and lint skills to ensure consistent wiki structure.
testing
Show status of all LLM Wiki vaults — page counts, source counts, last activity, and git status. Use when user wants to see vault status, list vaults, or check wiki health.
documentation
Import an existing Obsidian vault, markdown folder, or git repo as an llm-wiki vault. Moves content into vaults/, adds missing structure (index, log, CLAUDE.md, frontmatter). Use when user wants to import, adopt, migrate, or bring in an existing knowledge base.