andredezzy/maccing

Overview

This skill validates and diagnoses the pictura plugin installation to confirm it is generating images and responding as expected. It runs a standardized validation runner, interprets results, and provides concrete remediation steps for any failures. Use it to gain a clear production-readiness decision and actionable fixes.

How this skill works

The skill executes the pictura validation runner (pictura_validate) to run a suite of checks against the plugin and environment. It parses each check as PASS, FAIL, WARN, or SKIP and produces specific guidance: what failed, why, exact commands to fix, and how to verify the fix. Finally, it summarizes production readiness and lists any blockers and next steps.

When to use it

• User asks "is pictura working?" or reports generation failures
• After initial pictura setup or plugin installation
• Before deploying pictura to production
• When troubleshooting runtime errors or unexpected output
• When diagnosing integration or environment issues affecting pictura

Best practices

• Run pictura_validate immediately after installation and after config changes
• Treat FAIL results as critical and follow provided exact fix commands
• Document WARN items and schedule follow-up remediation if they impact reliability
• Re-run validation after applying fixes to confirm resolution
• Keep environment and dependency versions consistent with validation expectations

Example use cases

• A developer reports blank or malformed images; run the validation to locate the failing check and apply the fix command.
• Before a production cutover, run the validator to confirm all critical checks pass and get a Production Ready statement.
• A CI job intermittently fails when invoking pictura; use the skill to reproduce and surface environmental WARNs or SKIPs.
• After upgrading TypeScript or plugin dependencies, validate to catch regressions introduced by the upgrade.