XIP Writing Skill

This skill guides writing XerahS Improvement Proposals (XIPs) that are actionable, well-structured, and aligned with project architecture.

Workflow: GitHub is the source of truth for XIPs; the tasks/ folder is a backup. Create and edit XIPs as GitHub issues (label xip), then run the sync script to update the tasks folder. See sync-xips for create/edit/sync workflows.

What is a XIP?

A XIP (XerahS Improvement Proposal) is a design document that:

• Describes a new feature, enhancement, or architectural change
• Provides implementation guidance for developers
• Serves as the single source of truth for the feature scope
• Links to a GitHub issue for tracking

XIP Structure