skf-update-skill

Update existing skills from source code changes while preserving developer content.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of updating existing skills while preserving developer-authored content and ensuring accurate provenance tracking of changes.

Core Features & Use Cases

  • Surgical Updates: Updates skills based on source code changes, re-extracting only affected exports and preserving [MANUAL] sections.
  • Provenance Tracking: Ensures every regenerated instruction traces back to code with file:line citations.
  • Workflow Automation: Automates the update process with predefined stages and rules for change detection, re-extraction, merging, validation, and reporting.
  • Stack Skill Support: Handles stack skills by re-composing from updated constituents using skf-create-stack-skill.

Quick Start

Run the skf-update-skill command with the path to the skill directory or skill name.

Frequently Asked Questions about skf-update-skill

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

FAQPage Schema
How do I update existing code documentation without losing manually authored sections?

To update existing code documentation without losing manual sections, use surgical updates that re-extract only affected exports while preserving developer-authored [MANUAL] content. This ensures source code changes are reflected without overwriting custom instructions.

What is provenance tracking for source code analysis?

Provenance tracking for source code analysis ensures every regenerated instruction traces back to the original code with file:line citations. This mechanism maintains a verifiable link between generated documentation and its source.

Do I need Python and AST tools to automate skill updates?

Yes, you need Python and external AST analysis tools like ast-grep to automate skill updates. These dependencies provide the semantic enrichment and code analysis required for change detection and re-extraction operations.

How do I re-compose stack skills after updating underlying source code?

To re-compose stack skills after updating source code, use the skf-create-stack-skill operation to merge updated constituents. This handles stack skill support by re-composing from the individually updated base skills.

What is the best way to merge regenerated code analysis with existing skill data?

The best way to merge regenerated code analysis with existing skill data is through an automated workflow with predefined stages for change detection, re-extraction, merging, validation, and reporting. This preserves provenance tracking.