skills/by-role/qa/qa-release/SKILL.md
Manage QA release gates - go/no-go decisions, release sign-off reports, defect triage, and release readiness communication. Use this skill whenever a QA lead or manager needs to formally assess whether a build is ready to ship. Trigger on phrases like "release sign-off", "go or no-go", "is this ready to release", "defect triage", "release gate", "approve the release", "block the release", "release readiness", "quality gate", "sign off on this build", "triage these bugs", or any request to make or document a formal release decision. Also trigger when a release manager or PM asks "what's the QA status?" or "can we ship this?".
npx skillsauth add qa-aman/claude-skills qa-releaseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Based on the Google SRE Book and "Accelerate" by Forsgren, Humble & Kim. Google SRE's error budget concept reframes the release gate: instead of "is it good enough to ship?", ask "how much of the error budget does this risk consuming?" Accelerate's research shows that high-performing teams ship more frequently AND have lower change failure rates - speed and quality are not a tradeoff, they're correlated.
Run release gates, triage defects, and produce formal sign-off decisions.
Before triaging defects, confirm testing is done:
If testing is incomplete, record the gap and quantify the risk it represents.
Triage every open defect against the release:
For each defect, decide one of:
Triage criteria: | Severity | Default Decision | Override Condition | |----------|-----------------|-------------------| | P1 | Fix before release | None - P1 blocks release | | P2 | Fix before release | PM accepts risk in writing with mitigation | | P3 | Defer acceptable | Core user journey affected - escalate | | P4 | Defer | Always deferrable |
Document every override decision and who made it. Do not allow verbal agreements - get written approval on the ticket or in the release thread.
Evaluate against pre-agreed thresholds. If no thresholds exist, use these defaults:
| Gate | Default Threshold | Status | |------|-------------------|--------| | Regression pass rate | ≥ 95% | PASS / FAIL | | Open P1 defects | 0 | PASS / FAIL | | Open P2 defects | ≤ 2, all with accepted risk | PASS / FAIL | | Test coverage (new features) | 100% of P1 test cases executed | PASS / FAIL | | Performance regression | ≤ 10% degradation vs baseline | PASS / FAIL |
All gates must pass for a GO decision unless an explicit exception is documented.
SRE Error Budget framing (for teams with defined SLOs): If your team operates with SLOs and error budgets, frame the release decision as:
Accelerate's change failure rate benchmark:
Track your team's rolling change failure rate. If it exceeds 30%, the release gate thresholds are too permissive or the root causes are systemic.
State the decision clearly. Do not hedge.
GO - all quality gates pass, open defects triaged and accepted. NO-GO - one or more quality gates fail, or a P1 defect is open. CONDITIONAL GO - specific conditions must be met before shipping (e.g., one P2 fix required, then re-test and re-sign-off).
Release Sign-Off Report
Release: [version / release name]
Date: [date]
Environment: [staging / pre-prod]
QA Lead: [name]
Test Summary:
Regression pass rate: [x]%
Cases executed: [n] / [total]
Open defects: P1: [n] | P2: [n] | P3: [n] | P4: [n]
Quality Gate Results:
[gate name]: PASS / FAIL
[gate name]: PASS / FAIL
Defect Triage:
Fix before release: [IDs or "none"]
Hotfix: [IDs + commitment date or "none"]
Deferred: [IDs or "none"]
Exceptions approved by: [name, title]
Decision: GO / NO-GO / CONDITIONAL GO
Conditions (if applicable): [what must happen before shipping]
QA Sign-Off: [name]
Date/Time: [timestamp]
When running a triage meeting with engineering and PM:
Agenda (30 minutes max):
Rules:
Pressure-based approval "We promised the customer" is not a quality gate. If a P1 defect is open, the release is not ready. Document the business pressure and escalate - do not absorb it silently and approve anyway.
Verbal sign-off Release decisions must be written. A Slack message saying "looks good to me" is not sign-off. Use the template, document the decision, attach it to the release ticket.
Moving goalposts on quality gates Quality gates set the week before release should not be renegotiated the day before release. If business conditions change, escalate through the proper channel and document the new threshold and who approved it.
Shipping without testing incomplete areas If 20% of the regression suite could not be executed, that is not "95% pass rate on what we ran." Incomplete coverage is a risk that must be called out explicitly.
No post-release tracking Defects deferred or accepted for release must be tracked to resolution. Create follow-up tickets at triage time - not after the next defect reaches customers.
Before issuing any release sign-off:
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.