kf-manage

Manage Kiloforge track lifecycles with version-controlled archiving, restoration, and cleanup.

2|Updated Mar 11, 2026
One-click install
npx skills add https://github.com/Kiloforge/kiloforge-skills --skill kf-manage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kf-manage
Source: https://github.com/Kiloforge/kiloforge-skills/tree/main/kf-manage
Command: npx skills add https://github.com/Kiloforge/kiloforge-skills --skill kf-manage

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Kiloforge Track Manager enables teams to govern the full lifecycle of tracks—archiving completed work, restoring or deleting tracks, renaming identifiers, and cleaning up orphaned artifacts—while keeping the filesystem and registry in sync and safeguarded by explicit prompts and commits.

Core Features & Use Cases

  • Archive a single track to move it to the archive location and update the registry
  • Bulk archive all completed tracks and push a batch entry to the archive
  • Compact archived data to reclaim workspace space while preserving history
  • Restore an archived track back to active status with restored metadata
  • Delete a track permanently with explicit confirmation and audit trail
  • Rename a track ID and preserve history with previous_ids
  • Cleanup orphaned artifacts and synchronize tracks.yaml with filesystem state

Quick Start

Run the interactive Track Manager to organize active, completed, and archived tracks.

Frequently Asked Questions about kf-manage

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

FAQPage Schema
How do I archive completed tracks and keep the registry in sync?

You can archive completed tracks by moving them to the archive location and updating the registry, which ensures the filesystem and registry stay synchronized. Bulk archiving pushes a batch entry while preserving history.

Can I restore an archived track back to active status?

Yes, you can restore an archived track back to active status with its metadata fully restored. The process includes explicit pre-flight checks to ensure safe restoration before the track is reactivated.

What is the best way to clean up orphaned track artifacts?

Cleaning up orphaned artifacts involves synchronizing tracks.yaml with the filesystem state to remove stray files. This process ensures the registry accurately reflects the physical workspace without losing active track data.

How do I rename a track ID without losing version history?

Renaming a track ID preserves history by recording the original identifier in a previous_ids list. This maintains a continuous version-controlled record across the track's lifecycle despite the identifier change.

Does deleting a track permanently require explicit confirmation?

Yes, permanently deleting a track requires explicit confirmation to prevent accidental data loss. The operation generates an audit trail and commits the change to maintain strict safety checks.

When should I compact archived track data?

You should compact archived data to reclaim workspace space while preserving the historical record. This is applicable when accumulated archived tracks consume excessive storage but must remain accessible for auditing.