design-to-cr

Drafts, validates, and files change request issues in Netcracker/qubership-envgene from settled designs.

8|15|Updated Jan 17, 2025
One-click install
npx skills add https://github.com/Netcracker/qubership-envgene --skill design-to-cr-netcracker
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-to-cr
Source: https://github.com/Netcracker/qubership-envgene/tree/main/.claude/skills/design-to-cr
Command: npx skills add https://github.com/Netcracker/qubership-envgene --skill design-to-cr-netcracker

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning a settled design into a well-formed implementation issue is error-prone: links break after branch deletion, code internals leak into analyst-facing text, and issues get filed prematurely. This Skill enforces a draft-validate-publish pipeline so every change request in Netcracker/qubership-envgene is bounded, link-stable, and publish-ready before it is filed. ## Core Features & Use Cases - Two seeding sources: Parse an existing design doc or doc PR, or synthesize a draft from the working conversation and code investigation, with one shared downstream pipeline. - Dry-run drafting with iteration: Produces a local Markdown draft first, re-reads it every turn to preserve hand edits, and files only after explicit user confirmation. - Link rigor and pre-file gate: Requires commit-SHA permalinks and PR references that survive merges, plus a mechanical checklist blocking code references, undocumented identifiers, and house-rule violations. - Use Case: After finalizing a feature design doc PR, ask to file a CR; the Skill parses the doc, drafts the six-section issue body with per-item anchor links, iterates with you, then creates the typed GitHub issue via MCP tools. ## Quick Start Ask the assistant to turn the settled design doc PR into a change request issue in qubership-envgene and review the local draft before saying file it.

Frequently Asked Questions about design-to-cr

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

FAQPage Schema
How do I turn a design doc into a GitHub issue?▼

Provide the doc PR URL, PR number, or a docs/features/*.md path as the source. The Skill parses it into a six-section CR draft saved as a local Markdown file, then files the issue only after you explicitly confirm with words like file it or publish.

How to create a change request without a design document?▼

The Skill can synthesize the draft from the working context: the conversation, code investigation, and memory. However, a design reference link is still mandatory; without a committed design doc or PR to link, the work is not ready for a CR and the Skill stops.

Does this Skill work with repositories other than qubership-envgene?▼

No. The target repository is hardcoded to Netcracker/qubership-envgene and the Skill fails loudly on any other repository. Cross-repo use requires forking or adapting the Skill.

Why do design reference links need commit-SHA permalinks?▼

Branch-pinned URLs break when the source branch is deleted after merge. Commit-SHA permalinks and PR number references survive the merge, keeping every in-scope item's anchor link resolvable for the implementing developer.

Can the Skill push branches or open pull requests?▼

No. It only creates the GitHub issue via MCP tools and never pushes branches or opens PRs. Shipping the design docs is a separate flow that the CR simply links to.