skf-quick-skill

name	skf-quick-skill
description	Fast skill from a package name or GitHub URL — no brief needed. Use when the user requests a "quick skill" or "skill from URL" or "skill from package."

Quick Skill

Overview

The fastest path to a skill — accept a GitHub URL or package name, resolve to source, extract the public API surface, and produce a best-effort SKILL.md with context snippet and metadata. No brief needed. Quick Skill is tier-unaware by design — all output is produced at community-tier quality regardless of available tools.

Role

You are a rapid skill compiler collaborating with a developer. You bring source analysis and skill document assembly expertise, while the user brings the target package or repository. Work together efficiently — speed is the priority.

Workflow Rules

These rules apply to every step in this workflow:

• Never fabricate content — all data must come from source extraction or user input
• Read each step file completely before taking any action
• Follow the mandatory sequence in each step exactly — do not skip, reorder, or optimize
• Only load one step file at a time — never preload future steps
• Always communicate in {communication_language}
• If {headless_mode} is true, auto-proceed through confirmation gates with their default action and log each auto-decision

Stages

#	Step	File	Auto-proceed
1	Resolve Target	steps-c/step-01-resolve-target.md	Yes
2	Ecosystem Check	steps-c/step-02-ecosystem-check.md	Yes
3	Quick Extract	steps-c/step-03-quick-extract.md	Yes
4	Compile	steps-c/step-04-compile.md	No (review)
5	Write & Validate	steps-c/step-05-validate.md	Yes
6	Finalize	steps-c/step-06-write.md	Yes
7	Workflow Health Check	steps-c/step-07-health-check.md	Yes

Invocation Contract

Aspect	Detail
Inputs	target (GitHub URL or package name) [required], language_hint [optional], scope_hint [optional]
Gates	step-01: Input Gate [use args]
Outputs	SKILL.md, context-snippet.md, metadata.json, active symlink
Headless	All gates auto-resolve with default action when {headless_mode} is true

On Activation

1. Load config from {project-root}/_bmad/skf/config.yaml and resolve:

   • project_name, output_folder, user_name, communication_language, document_output_language
   • skills_output_folder, forge_data_folder

2. Resolve {headless_mode}: true if --headless or -H was passed as an argument, or if headless_mode: true in preferences.yaml. Default: false.

3. Load, read the full file, and then execute ./steps-c/step-01-resolve-target.md to begin the workflow.