Deployment Logic (upload)
The primary execution engine. Recursively scans for skill folders, patches metadata, and fulfills batch queues.
LOGIC FLOW: The combination of COMMAND: UPLOAD and FLAGS triggers the engine to initialize the persistent browser context and process the batch queue through the VALIDATE gate.
Project Scaffolding (init)
Generates a standardized Claude skill folder structure with a pre-configured SKILL.md manifest and recursive safety ignores.
LOGIC FLOW: SCAFFOLDING logic ensures that every new skill follows the rigid directory hierarchy required for the UPLOAD engine to parse it flawlessly.
Progress Metrics (status)
Provides a high-speed summary of batch completion ratios relative to local history versus total source folder depth.
LOGIC FLOW: ANALYTICS mapping compares the .claudforge/history.json array with the current filesystem state to calculate real-time deployment ETAs.
Inventory Scanning (list)
Extracts and displays every skill identity recorded in the persistent local history array for quick auditing.
LOGIC FLOW: INVENTORY logic executes a read-only stream of the global manifest, grouping skills by their SKILL.md version tags.
Metadata Auditing (validate)
Performs deep structural analysis on your SKILL.md files. Checks for reserved words (Anthropic quarantine) and YAML syntax compliance.
LOGIC FLOW: OFFLINE_LINT runs a regex-based quarantine scanner before the browser ever launches, preventing account flags for invalid skill payloads.
Health & Verification (doctor)
Performs a multi-layer ecosystem audit. Verifies Chrome binaries, Playwright drivers, and config security (0700).
LOGIC FLOW: SYSTEM_AUDIT systematically polls the local environment variables and Playwright driver status to ensure the IRONCLAD engine has full system-level clearance.
Library Hygiene (prune)
Cleans up temporary zipped assets and clears engine log history to maintain sub-millisecond local efficiency.
LOGIC FLOW: MAINTENANCE routines target the transient pkg/ folders and .claudforge/logs, preventing cache bloat during high-volume rotations.
Time-Travel Revert (rollback)
Reverts a specific remote skill to a previous version derived from the automated local snapshot archive.
LOGIC FLOW: VERSIONING logic leverages the local shadow/ directory to find the last known-good package state and force-reinjects it into the target profile.
Real-Time Monitor (dashboard)
Launches a Streamlit-powered visual dashboard for live log streaming and ETR tracking of long-running batches.
LOGIC FLOW: MONITORING triggers a secondary Python thread that serves the Rich log output as a visual dataframe for cross-device observability.
Target Destruction (uninstall)
Runs a highly targeted Playwright script to locate a precise skill and instantly process its destruction sequence.
LOGIC FLOW: TEARDOWN logic bypasses traditional GUI menus, utilizing CSS selector hunting to locate and purge the specific skill UID with millisecond precision.
Global Wipe Protocol (uninstall-all)
Loops dynamically through the current workspace, mass-deleting all uploaded custom skills while actively scanning for and quarantining Anthropic-origin skills.
LOGIC FLOW: GLOBAL_PURGE combines workspace walking with the Anthropic Quarantine engine to ensure only user-created content is targeted for deletion.
SKILL.md Configuration
Every skill folder must contain a SKILL.md file with the following YAML frontmatter:
---
name: "My Powerful Skill"
description: "A detailed explanation of AI behavior"
version: "1.0.0"
---
# Skill Content starts here...
💡 Pro Tip: ClaudForge automatically escapes complex characters and fixes malformed YAML during deployment.