OpeItcLoc03/claude-skills
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
8c547d73af01d2e473a965555fefa8dcab16d6c1
claude-skills/.wiki/index.md
vitya 8c547d73af feat(project-bootstrap): generic Step 5.6 skill-deps check 
Collapse Step 5.6 from a single-skill detector (only the
superpowers@claude-plugins-official plugin) into a generic
`trigger -> fulfiller` table walker that scales to every canonical
CLAUDE.md trigger.

Inline 9-row map in SKILL.md covers: caveman, superpowers (kind: plugin),
using-wiki, using-tasks, using-projects-meta, pulling-before-work,
project-discipline, using-interns, active-platform. The `kind` flag
(skill | plugin) drives which install command is emitted in the chat-only
recommendation block. Detection paths: ~/.claude/skills/<name>/SKILL.md
for skills, plugins.<id> in ~/.claude/plugins/installed_plugins.json
for plugins.

Algorithm: read project's CLAUDE.md -> match each non-comment line vs
map (substring + tolower, mirrors Step 5 idempotent merge) -> for each
canonical match check disk -> print one chat block listing every missing
fulfiller with copy-pasteable install commands, OR a single
"all dependencies satisfied" line. User-custom lines and removed
canonical lines are silently skipped. Hard rule "never auto-install"
preserved verbatim.

version: 1.6.0 -> 1.7.0 (MINOR per project-discipline Rule 3 -- adds
capability, absorbs prior superpowers-only detector cleanly).

Closes [bootstrap-skill-deps-check] (.tasks/STATUS.md done).
Closes [bootstrap-recommend-projects-meta] by absorption -- the deferred
mirror task was the seed of this generalization; the generic walker now
handles using-projects-meta along with everything else, no per-skill
mirror needed.

Design rationale at .wiki/concepts/bootstrap-skill-deps-check.md:
- why generic over per-skill mirrors (5x mirror explosion)
- skill vs plugin kind distinction
- MCP-server-backed skills (only check using-X policy skill;
  setup-X self-fires via Prerequisites pointer)
- source-of-truth invariant: SKILL map + assets/CLAUDE.md.template
  must stay in sync (a future CI lint could enforce)
2026-05-05 21:21:19 +03:00

3.3 KiB
Raw Blame History

Wiki Index

Catalog of all wiki pages. One line per page, organized by type. Updated on every ingest / new page.

Overview

  • overview.md — what claude-skills is, layout, how to navigate

Entities

Concepts

  • active-platform-decision.md — why active-platform is a skill (not a memory entry); why default = Windows; how it's wired into project-bootstrap
  • bootstrap-claude-md-merge.md — project-bootstrap@1.3.0 — Step 5 upgrade path becomes idempotent merge (read → diff vs template → confirm → append missing); fixes silent gap where pre-1.2.0 projects never picked up new canonical triggers (check across all projects, we're on Windows)
  • bootstrap-skill-deps-check.md — project-bootstrap@1.7.0 — Step 5.6 collapses the per-skill "detect-and-recommend" mirror shape into one generic trigger → fulfiller table walker (skill vs plugin kind, never auto-install); subsumes the deferred [bootstrap-recommend-projects-meta] and the existing superpowers-only detector
  • bootstrap-manifest.md — record of which project-bootstrap / setup-wiki / setup-tasks versions initialized this project's .wiki/ and .tasks/ layout (overwritten on re-bootstrap; history in git)
  • build-notes.md — why build.ps1 exists alongside build.sh; PS 5.1 backslash-in-zip gotcha; how to extract a .skill
  • install-portability.md — install.sh / build.sh rewritten to drop mapfile (bash 4+) and find -printf (GNU only) so stock macOS (bash 3.2 + BSD find) works
  • context7-setup.md — switched context7 from manual MCP entries to the official plugin; API key in .mcp.json as --api-key; now also captured as setup-context7 skill (one-time install/migrate flow with key discovery)
  • projects-meta-skills.md — setup-projects-meta + using-projects-meta skill pair for the local projects-meta-mcp stdio server (cross-project tasks + shared Gitea wiki); local-first rule + two-step mutation pattern
  • project-discipline-design.md — design for project-discipline (four cross-project rules: conventions-over-defaults, master-only, semver-bumping, ask-before-push)
  • pulling-before-work-design.md — design for the pulling-before-work skill (mode-3 + skip-on-dirty)
  • repo-layout.md — flat skills/, committed dist/, bash + PowerShell scripts; install model
  • skill-versioning.md — why infra skills carry version: <semver> in frontmatter and how project-bootstrap records them in a per-project manifest
  • skill-vs-plugin.md — when a bare SKILL.md is enough vs when you actually need a plugin (slash commands, hooks, sub-agents, MCP servers); concrete breakdown of superpowers
  • wiki-realignment.md — fixing project-bootstrap to create the Karpathy-canonical wiki layout
  • interns-design — interns-design

Packages

Sources

Reference in New Issue View Git Blame Copy Permalink