skf-setup

Automate Forge environment setup, detect tools, and write configuration files.

Updated Apr 15, 2026
One-click install
npx skills add https://github.com/delorenj/voxxy --skill skf-setup-delorenj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: skf-setup
Source: https://github.com/delorenj/voxxy/tree/main/.augment/skills/skf-setup
Command: npx skills add https://github.com/delorenj/voxxy --skill skf-setup-delorenj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ast-grep, gh, qmd, ccc, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the setup of the Forge environment, detects available tools, and sets the capability tier (Quick/Forge/Forge+/Deep) for the Forge system.

Core Features & Use Cases

  • Forge Environment Initialization: Initializes the Forge environment by detecting available tools and setting the capability tier.
  • Tool Detection: Detects the availability of essential tools like ast-grep, gh, qmd, and ccc.
  • Tier Setting: Determines the capability tier based on detected tools, allowing for Quick, Forge, Forge+, or Deep tiers.
  • Configuration Writing: Writes the detected tool availability and calculated tier to forge-tier.yaml and creates preferences.yaml if it does not exist.
  • QMD Hygiene: Verifies the health of existing QMD collections for Deep tier and cleans up orphaned or stale entries.
  • Report Generation: Generates a comprehensive report detailing the Forge status, including detected tools, tier, and hygiene results.

Quick Start

Run the skf-setup skill to automatically set up the Forge environment and detect tools.

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 tool detection?

Automating Forge environment setup involves detecting available tools like ast-grep, gh, qmd, and ccc to calculate capability tiers. This Skill initializes the environment, determines the tier, and writes configuration files automatically.

What are Forge capability tiers and how are they calculated?

Forge capability tiers (Quick, Forge, Forge+, Deep) are calculated based on the availability of essential tools. The system detects tools like ast-grep, gh, qmd, and ccc, then assigns a tier reflecting the environment's capabilities.

Do I need ast-grep, gh, qmd, and ccc installed to configure the Forge platform?

Yes, ast-grep, gh, qmd, and ccc are required dependencies for tool detection and tier calculation. The setup process checks for these specific tools to determine the Forge environment's capability tier.

What configuration files are generated during Forge environment initialization?

Forge environment initialization generates a forge-tier.yaml file containing detected tool availability and calculated tier, and creates a preferences.yaml file if it does not already exist in the system.

How does QMD hygiene verification work for the Deep tier in Forge?

QMD hygiene verification for the Deep tier checks the health of existing QMD collections and cleans up orphaned or stale entries. This ensures data integrity when the highest capability tier is active.

Can I generate a status report after setting up the Forge environment?

Yes, a comprehensive report is generated detailing the Forge status, including detected tools, assigned capability tier, and QMD hygiene results, providing a complete overview of the environment configuration.