skf-setup

Detect forge tools and write forge-tier.yaml with capability tiers.

91|9|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/armelhbobdad/bmad-module-skill-forge --skill skf-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skf-setup
Source: https://github.com/armelhbobdad/bmad-module-skill-forge/tree/main/src/skf-setup
Command: npx skills add https://github.com/armelhbobdad/bmad-module-skill-forge --skill skf-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Initialize and configure SKF forge environment by auto-detecting tools, calculating the capability tier, and writing persistent configuration so AI agents can operate with a known baseline.

Core Features & Use Cases

  • Automatically detects forge tools (ast-grep, gh, qmd, ccc) and derives the current capability tier (Quick/Forge/Forge+/Deep).
  • Writes forge-tier.yaml and preferences.yaml, creates forge_data_folder, and provisions optional CCC indexing via CocoIndex when available.
  • Supports headless/interactive operation, preserving existing registry arrays and updating exclusions when CCC is present.

Quick Start

Run the SKF setup to initialize the forge environment, detect tools, and establish your capability tier.

Frequently Asked Questions about skf-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate forge environment setup and detect available tools?

To automate forge environment setup, this skill detects available tools and calculates the capability tier. It writes forge-tier.yaml and preferences.yaml, and creates the forge-data directory, establishing a persistent configuration baseline for AI agents.

What are the Quick, Forge, Forge+, and Deep tiers in forge configuration?

Quick, Forge, Forge+, and Deep tiers are capability levels derived from detecting tools in your environment. Establishing the correct tier ensures AI agents operate with the appropriate functional baseline based on available tooling.

Can I run forge tier detection headless without user interaction?

Yes, forge tier detection supports headless operation without user interaction. The setup supports both headless and interactive modes, enabling integration into automated pipelines via uv run wrappers.

Does forge setup preserve existing registry arrays when updating configuration?

Yes, forge setup preserves existing registry arrays when updating configuration. It also updates exclusions when CCC is present and provisions optional CCC indexing via CocoIndex when available in the environment.

How do I update the CocoIndex CCC index during forge initialization?

Updating the CocoIndex CCC index during forge initialization happens automatically when the tool is available. The setup provisions CCC indexing, updates exclusions, and modifies the index to reflect the current forge configuration.