Production readiness
Skill Meghshyams/Production-Readiness/skills/production-readiness
Run a comprehensive production readiness audit. Use when a user wants to check if their project is ready for deployment. Covers security & supply chain, visual QA, code quality, testing, error handling & observability, configuration/build, performance, accessibility, and AI/LLM safety.From its SKILL.md
npx -y skills add Meghshyams/Production-Readiness --skill production-readinessAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 4 stars4 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
10.3 KB, ~2.2k tokens by cl100k_base, as published. Nobody here has run it
Production Readiness Audit
You are a senior engineer and QA tester performing a final production readiness review. Your job is to systematically evaluate the project across 9 pillars and produce an actionable report.
Arguments
$ARGUMENTScan include:--skip=phase1,phase2— skip specific phases (e.g.,--skip=visual,performance)--only=phase1,phase2— run only specific phases (e.g.,--only=security,testing)--port=NNNN— override dev server port (default: auto-detect)--fresh— ignore any cached results, run all phases from scratch--cached— display the last cached report without running anything (quick review)--fix— after the report, offer to apply safe mechanical fixes (see "Fix Mode" below)- No arguments = run all 9 pillars (with smart caching if available)
Phase names: security, visual, quality, testing, build, errors, performance, accessibility, ai
Execution Flow
Progress Tracking
Before starting, create tasks for each phase that will run using TaskCreate. Update each task to in_progress when starting and completed when done. This gives the user real-time visibility into audit progress.
Parallel Execution Strategy
After Phase 1 (Detection) completes, the following phases are independent and can run concurrently:
- Group A: Security & Supply Chain (Phase 2) + Code Quality (Phase 3) + Error Handling & Observability (Phase 5)
- Group B: Testing (Phase 4) — may need dev server running
- Group C: Configuration & Build (Phase 6)
- Group D: Performance (Phase 8) + Accessibility (Phase 9) + AI/LLM Safety (Phase 10)
- Group E: Visual QA (Phase 7) — requires build to pass and dev server running
Run Group A, B, C, and D concurrently where possible. Group E depends on a successful build (Phase 6). AI/LLM Safety (Phase 10) only applies when the project integrates an LLM/AI provider (detected in Phase 1) — skip it with a note otherwise.
Phase 11 (Save) always runs last after all other phases complete.
Dispatching subagents: Subagents do NOT inherit this skill's context. When dispatching a phase group via the Agent tool, each subagent's prompt must include:
- An instruction to first Read the relevant phase file(s) — give the absolute path(s), e.g.
<skill-dir>/phases/02-security.md— and follow every check in them. - The Phase 1 detection summary (framework, package manager, test runner, ORM, deploy target, etc.) so the agent doesn't re-detect.
- The required return format: for each phase, a JSON object with
phase,status(PASS/FAIL/SKIPPED),critical/warnings/infocounts, and afindingsarray where each finding hasseverity,title,location(file:line),details, andfix. The orchestrator merges these into the final report — nothing else from the subagent's output is used. - A reminder not to modify any files (audit only; fixes happen later via Fix Mode).
Fix Mode (--fix)
If --fix was passed, after presenting the report:
- List the findings that have safe, mechanical fixes — e.g.: add
.env/.production-readiness/to.gitignore, create.env.examplefrom.envkeys (values stripped), add a.dockerignore, addlangto<html>, addalt=""to decorative images, removedebuggerstatements and committed.onlyin tests, pin a:latestDocker base tag. - Ask the user to confirm which to apply (default: all listed).
- Apply the confirmed fixes with Edit/Write, then show a summary of changed files.
Never auto-fix anything judgment-dependent (auth logic, CSP values, query rewrites, dependency upgrades) — for those, the report's fix suggestion is the deliverable. Never run --fix changes without listing them first.
Phase 1: Detection & Cache Status
Detect the project stack (framework, package manager, test runner, lint tool, ORM, routes, screenshot capability, dev server, build command, CI/CD). Present findings, check cache status, and confirm with the user before proceeding.
→ See phases/01-detect.md
Phase 2: Security & Supply Chain Audit
17 checks covering hardcoded secrets, environment safety, dependency vulnerabilities, input validation, authentication, rate limiting, security headers, error exposure, SQL injection, XSS, CORS configuration, dependency licenses, git-history secret scanning, lockfile integrity, build provenance/SBOM, dependency freshness, and webhook signature verification.
→ See phases/02-security.md
Phase 3: Code Quality
6 checks covering debug statements, unresolved tech debt (TODO/FIXME), lint errors, type checking, unused dependencies, and security/anti-pattern linting.
→ See phases/03-quality.md
Phase 4: Testing
4 checks covering test suite execution, coverage metrics, critical path coverage (auth, payments, mutations), and test health (skipped/.only tests, flakiness signals).
→ See phases/04-testing.md
Phase 5: Error Handling & Observability
8 checks covering global error boundaries, error tracking integration, health check endpoints, structured logging, sensitive data in logs, distributed tracing (OpenTelemetry) with correlation IDs, graceful shutdown handling, and monitoring & alerting.
→ See phases/05-errors.md
Phase 6: Configuration & Build
13 checks covering build verification, environment documentation, source maps, development leaks, HTTPS redirects, Docker configuration, Docker Compose security, container orchestration, platform deployment configs, serverless/edge fitness, CI/CD pipeline hygiene, database migration safety, and runtime version pinning.
→ See phases/06-build.md
Phase 7: Visual QA
Screenshot collection and visual inspection at desktop (1440x900) and mobile (375x812) viewports. Evaluates layout, responsiveness, content, visual consistency, and broken UI. Requires Playwright.
→ See phases/07-visual.md
Phase 8: Performance (Static Analysis)
12 checks covering image optimization, bundle size, caching headers, database query patterns, lazy loading, Core Web Vitals, font optimization, third-party scripts, API response size, compression, database connection management, and rendering/asset delivery.
→ See phases/08-performance.md
Phase 9: Accessibility
8 checks covering semantic HTML, ARIA labels, keyboard navigation, color contrast, screen reader support, automated accessibility testing, WCAG 2.2 criteria (touch-target size, focus-not-obscured, accessible auth), and language & media alternatives. Applies to frontend projects only.
→ See phases/09-accessibility.md
Phase 10: AI/LLM Safety
7 checks covering prompt-injection surfaces, secret/PII leakage into prompts, untrusted LLM output handling, token/cost guardrails, model & SDK pinning, AI endpoint reliability & error handling, and AI observability & abuse controls. Applies only when an LLM/AI provider integration is detected.
→ See phases/10-ai-llm.md
Phase 11: Save Results
Cache all results for future incremental reruns and write the report file. This phase is silent — not included in the report.
→ See phases/11-save.md
Supporting References
- Cache Management — cache file structure, on-run behavior, phase-to-file-pattern mapping: cache-management.md
- Report Format — report template, verdict logic, cached labels, issue templates: report-format.md
Important Guidelines
- Be specific: Always include file paths and line numbers for issues.
- Be actionable: Every issue must have a concrete fix suggestion.
- Don't cry wolf: Only flag real issues. If something looks intentional (like console.log in a logger utility), note it as INFO, not WARNING.
- Acknowledge good practices: The "What's Good" section is required. Engineers need to know what they're doing right.
- Adapt to the stack: If a check doesn't apply to the detected stack, skip it and note why.
- Respect .gitignore: Never scan node_modules, build outputs, or other ignored directories.
- Time-box visual QA: If there are more than 30 pages, prioritize landing pages, auth flows, and main user journeys. Note which pages were skipped.
- Parallelize after Detection: Detection (Phase 1) must complete first. Then dispatch independent phase groups concurrently using the Agent tool as subagents. Build must succeed before Visual QA. Phase 11 (Save) always runs last.
- Handle failures gracefully: If a tool or command fails, note it in the report and continue with other phases. Don't let one failure block the entire audit.
- Use parallel tool calls: When checking multiple independent things (e.g., different security patterns), use parallel grep/glob calls to speed up the audit.
- Cache conservatively: Only use cached results when confident nothing changed. When in doubt, rerun the phase. Production readiness must not be compromised for speed.
- Suggest gitignoring cache: If
.production-readiness/is not in.gitignore, suggest adding it — these are local audit artifacts, not meant to be committed.
What ships with it: 13 files
56.0 KB alongside SKILL.md
phases/
- 01-detect.md5.4 KB
- 02-security.md9.8 KB
- 03-quality.md2.9 KB
- 04-testing.md2.2 KB
- 05-errors.md3.9 KB
- 06-build.md6.9 KB
- 07-visual.md2.0 KB
- 08-performance.md4.9 KB
- 09-accessibility.md4.6 KB
- 10-ai-llm.md5.7 KB
- 11-save.md886 B
- cache-management.md3.7 KB
- report-format.md3.1 KB
Gives 0 of the 12 instructions most ship operate skills give in ~2.2k tokens
Counted across 1,077 of the 1,713 authors here whose files we hold, read 2026-09-06
- Create GitHub releasein 44 of 1077, across 43 files
- Run the test suitein 30 of 1077, across 25 files
- Create and push git tagin 27 of 1077, across 26 files
- Push commits and tagsin 27 of 1077
- Create annotated tagin 25 of 1077, across 22 files
- Ensure working tree is cleanin 24 of 1077
- Check for product marketing context firstin 23 of 1077, across 6 files
- Commit version bump changesin 22 of 1077, across 21 files
- Update CHANGELOG.mdin 21 of 1077, across 20 files
- Structure launch marketing across three channel typesin 20 of 1077, across 5 files
- Commit and tag the releasein 20 of 1077, across 18 files
- Update the CHANGELOG for new releasesin 19 of 1077
Said here and by no other author read
- Update each task to in_progress
- Update each task to completed
- Run independent phases concurrently
- List findings with safe mechanical fixes
- Apply confirmed fixes with Edit
- Detect the project stack
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.