feat(skills): add diagnose skill for AI workflow health check 🤖🤖🤖

[alfersugo]

Summary

Adds a new diagnose skill for systematically auditing AI workflow quality across 5 dimensions.

What this skill does

Performs a structured diagnostic scan and produces a scored report with prioritized remediation actions.

5 dimensions:

1. Prompt Quality — structure, output schema, clarity, edge cases
2. Context Efficiency — budget allocation, attention gradient, state management
3. Tool Health — count, description quality, error handling, idempotency
4. Architecture Fitness — topology, agent boundaries, handoff protocols, observability
5. Safety & Reliability — input validation, output filtering, cost controls, error recovery

Output: ASCII box report with 1–5 scores per dimension, overall score (X/25), critical findings, and ranked remediation actions.

Usage trigger

Invoke when a user wants to:

• Find hidden problems before a workflow goes to production
• Audit an existing agent for quality and reliability
• Get a prioritized remediation plan
• Health-check a workflow after significant changes

Validation

• npm run skill:validate ✅ passes
• npm run build ✅ docs updated

[github-actions]

🔍 Skill Validator Results

✅ All checks passed

Scope	Checked
Skills	1
Agents	1
Total	2
Severity	Count
---	---:
❌ Errors	0
⚠️ Warnings	0
ℹ️ Advisories	0

Summary

Level	Finding
ℹ️	Found 1 skill(s)
ℹ️	[diagnose] 📊 diagnose: 983 BPE tokens [chars/4: 1,005] (detailed ✓), 9 sections, 1 code blocks
ℹ️	✅ All checks passed (1 skill(s))

Full validator output

```text Found 1 skill(s) [diagnose] 📊 diagnose: 983 BPE tokens [chars/4: 1,005] (detailed ✓), 9 sections, 1 code blocks ✅ All checks passed (1 skill(s)) ```

[Copilot]

Pull request overview

Adds a new diagnose skill to the skills catalog so Copilot can audit AI workflows across prompt, context, tooling, architecture, and safety dimensions, and updates the generated skills index accordingly.

Changes:

• Adds skills/diagnose/SKILL.md with the new diagnostic workflow, scoring rubric, and report template.
• Defines the five evaluation dimensions and a sample scored report/output format.
• Updates docs/README.skills.md to include the new skill in the generated skills table.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
skills/diagnose/SKILL.md	New skill definition for AI workflow diagnostics, including front matter, scoring guidance, and output template.
docs/README.skills.md	Adds the generated catalog entry for the new diagnose skill.