Two tools with basic schemas but significant quality gaps. Tool names lack clear action verbs (audit, setup-github-workflow are vague). Descriptions are present but generic (audit: 108 chars, setup: 97 chars), below the 194-char baseline for production tools. Parameter descriptions exist but lack specificity: 'Comma-separated list' is vague; no format constraints, ranges, or examples. No output schema documented for either tool. Error handling absent, no guidance on retryability, user-fixable errors, or recovery paths. Missing idempotency hints for the WRITE tool. No tool annotations (readOnlyHint/destructiveHint). Schemas lack enum constraints for 'fail-on' parameter (should be constrained to: none|minor|moderate|serious|critical). Overall: functional but well below production baseline.

• Rename 'audit' → 'run_accessibility_audit' and 'setup-github-workflow' → 'create_github_audit_workflow' to start with clear action verbs.
• Document output schemas: audit should return {violations: [{rule, severity, elements}], summary: {passed, failed, incomplete}, urls_checked: []}; setup should return {workflow_path, status, repository}.
• Convert 'fail-on' to an enum parameter with values: ['none', 'minor', 'moderate', 'serious', 'critical']. Add description: 'Fail the audit if violations at or above this severity are found.'
• Add error handling: document which errors are retryable (network timeouts, rate limits) vs user-fixable (invalid URL format, GitHub auth required) vs fatal. Return actionable messages like 'Invalid URL: must start with http:// or https://. Got: {value}'.
• Add tool annotations: audit should have readOnlyHint=true; setup-github-workflow should have destructiveHint=true and require confirmation via MRTR (Multi Round-Trip Request) pattern before modifying the repo.