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.