armelhbobdad/oh-my-skills / .claude/skills/skf-setup
skf-setup
VerifiedInitialize forge environment, detect tools, and set capability tier (Quick/Forge/Forge+/Deep). Use when the user requests to "set up the forge" or "initialize the forge".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.4 KB |
| customize.toml | config | 1.9 KB |
| references/auto-index.md | markdown | 7.8 KB |
| references/ccc-index.md | markdown | 4.4 KB |
| references/detect-and-tier.md | markdown | 8.3 KB |
| references/health-check.md | markdown | 1.5 KB |
| references/invocation-contract.md | markdown | 5.4 KB |
| references/report.md | markdown | 8.2 KB |
| references/tier-rules.md | markdown | 1.7 KB |
| references/write-config.md | markdown | 4.9 KB |
references/ccc-index.md
View on GitHub---
nextStepFile: 'write-config.md'
# `{mergeCccExclusionsHelper}` = first existing path in
# `{mergeCccExclusionsProbeOrder}`; halt if neither exists.
mergeCccExclusionsProbeOrder:
- '{project-root}/_bmad/skf/shared/scripts/skf-merge-ccc-exclusions.py'
- '{project-root}/src/shared/scripts/skf-merge-ccc-exclusions.py'
# `{emitEnvelopeHelper}` = first existing path in `{emitEnvelopeProbeOrder}`,
# for the blocked envelope a halt in this step emits under headless or quiet.
emitEnvelopeProbeOrder:
- '{project-root}/_bmad/skf/shared/scripts/skf-emit-result-envelope.py'
- '{project-root}/src/shared/scripts/skf-emit-result-envelope.py'
---
<!-- Config: communicate in {communication_language}. User-visible status messages (indexing progress message) render in the user's language. -->
# Step 1b: CCC Index
## STEP GOAL:
When ccc is available, run `{mergeCccExclusionsHelper}` once: it prepares `.cocoindex_code/settings.yml` (running `ccc init` when needed), keeps its SKF exclusion patterns current, builds or refreshes the project index when it needs it, and writes its result to `{run_dir}/ccc-exclusions.json`, where step 2 and step 4 read it.
## Rules
- The script owns `ccc init`, every `settings.yml` edit, the index decision, `ccc index` and `ccc status`: run none of them yourself, and bind nothing from its output (steps 2 and 4 read the result file)
- Do not fail the workflow if settings preparation or ccc indexing fails: the result file records the failure, and the report shows it
- Display messages only when `{quiet_mode}` is false; the one exception is the envelope line a halt displays
- When `{quiet_mode}` is true, write no assistant text at all between tool calls: no status, progress or step-transition notes, however brief
- If no path in `mergeCccExclusionsProbeOrder` exists when section 2 runs (an install fault, not a settings failure), halt with phase `step 1b:helper-missing`, `path` set to its first entry, and reason `Setup cannot proceed: skf-merge-ccc-exclusions.py was not found. Reinstall SKF, then re-run /skf-setup.`
- Every halt follows the SKILL.md halt contract: when `{quiet_mode}` is true, run `uv run {emitEnvelopeHelper} emit-blocked --phase '<phase>' --reason '<reason>' --path "<path>"`, which builds the payload itself (no `--path` for a halt without one, `--stderr-from` where the halt names it, and `--customization-resolver-unavailable "<reason>"` once SKILL.md On Activation item 6 bound `{customization_resolver_unavailable}` to a reason, escaped as the halt contract says), and display its stdout line verbatim and nothing else (the reason alone if `{emitEnvelopeHelper}` resolves to no path, or the helper exits non-zero or prints no line); otherwise display the reason
## MANDATORY SEQUENCE
### 1. Check Eligibility
If `{ccc}` (from step 1) is false, go to section 3 with no output. Otherwise continue to section 2, with or without `--ccc-skip-index`: the skip lane still prepares settings.yml, and only the index build is skipped.
### 2. Prepare the Settings and the Index
Unless `{quiet_mode}` is true, display: "**Preparing the ccc settings, then the semantic index if it needs building: a first index can take several minutes on large codebases (1000+ files). Run `ccc status` in another terminal to monitor progress.**"
Pass `{ccc_index_fresh}` (from step 1) and `{ccc_skip_index}` as `true` or `false`, and add `--defer-index` only when `{require_tier_satisfied}` (from step 1) is `false`: a run that ends `tier_failure` then builds no index that is due, while a fresh index record still carries forward. Run the call in the foreground with the shell's longest timeout (in an interactive run, an index that can outlast that timeout may run in the background instead, the step waiting for it to exit before it goes on; a headless run keeps it in the foreground); a call the shell stops at that timeout goes on as the paragraph after the command says:
```bash
uv run {mergeCccExclusionsHelper} \
--project-root "{project-root}" \
--config "{project-root}/_bmad/skf/config.yaml" \
--prior-state-from "{sidecar_path}/forge-tier.yaml" \
--index-fresh "{ccc_index_fresh}" \
--skip-index "{ccc_skip_index}" \
[--defer-index] \
--build-index \
--result-to "{run_dir}/ccc-exclusions.json"
```
Go on to section 3 however the call ends: a non-zero exit, or a call the shell stopped, is no workflow error either (steps 2 and 4 report it as a failed index).
### 3. Auto-Proceed
Load `{nextStepFile}`, read it fully, and execute it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |