aiskillstore/marketplace / skills/92bilal26/canonical-format-checker
canonical-format-checker
VerifiedThis skill should be used when content teaches patterns (skills, subagents, ADRs, PHRs, specifications) that have canonical sources elsewhere. Prevents format drift by ensuring content references and follows the authoritative format from canonical sources. Use before implementing lessons that teach platform patterns, or when reviewing content for format consistency.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.7 KB |
| skill-report.json | config | 43.7 KB |
skill-report.json
View on GitHub{
"schema_version": "2.0",
"meta": {
"generated_at": "2026-07-05T14:46:29.200Z",
"slug": "92bilal26-canonical-format-checker",
"source_url": "https://github.com/92Bilal26/TaskPilotAI/tree/main/.claude/skills/canonical-format-checker",
"source_ref": "main",
"model": "codex",
"analysis_version": "3.0.0",
"source_type": "community",
"content_hash": "3f2d5f08ff93f50c56197ac46467516a182e3bd048fd836b122770915114e98c",
"tree_hash": "3dc3c53426cfa17a466f7d02d3c02cf576b094bc261862b6ed0168a98ae9e75e",
"provenance": {
"model_effective": "codex",
"fallback_chain": [
{
"agent": "codex",
"outcome": "success"
}
],
"analysis_version": "3.0.0"
}
},
"skill": {
"name": "canonical-format-checker",
"description": "Checks lessons and documentation against canonical source formats to prevent drift in skills, subagents, ADRs, PHRs, specifications, and commands.",
"summary": "Verifies documentation formats against canonical sources before publication.",
"icon": "📦",
"version": "1.0.1",
"author": "92Bilal26",
"license": "MIT",
"tags": [
"canonical-format",
"documentation-review",
"format-drift",
"claude-code",
"content-validation"
],
"supported_tools": [
"claude",
"codex",
"claude-code"
],
"risk_factors": [
"external_commands"
],
"category": "documentation"
},
"security_audit": {
"risk_level": "safe",
"is_blocked": false,
"safe_to_publish": true,
"analysis_status": "ok",
"summary": "All 44 static findings are false positives caused by Markdown inline code and fenced examples, not Ruby backtick execution. The shell examples are read-only local inspection commands for canonical source review. No prompt injection or malicious intent was found in SKILL.md.",
"remediation": [],
"risk_factor_evidence": [
{
"factor": "external_commands",
"evidence": [
{
"file": "SKILL.md",
"line_start": 17,
"line_end": 17
},
{
"file": "SKILL.md",
"line_start": 18,
"line_end": 18
},
{
"file": "SKILL.md",
"line_start": 19,
"line_end": 19
},
{
"file": "SKILL.md",
"line_start": 20,
"line_end": 20
},
{
"file": "SKILL.md",
"line_start": 21,
"line_end": 21
},
{
"file": "SKILL.md",
"line_start": 32,
"line_end": 32
},
{
"file": "SKILL.md",
"line_start": 33,
"line_end": 33
},
{
"file": "SKILL.md",
"line_start": 34,
"line_end": 34
},
{
"file": "SKILL.md",
"line_start": 35,
"line_end": 35
},
{
"file": "SKILL.md",
"line_start": 36,
"line_end": 36
},
{
"file": "SKILL.md",
"line_start": 37,
"line_end": 37
},
{
"file": "SKILL.md",
"line_start": 47,
"line_end": 52
},
{
"file": "SKILL.md",
"line_start": 52,
"line_end": 58
},
{
"file": "SKILL.md",
"line_start": 58,
"line_end": 70
},
{
"file": "SKILL.md",
"line_start": 70,
"line_end": 76
},
{
"file": "SKILL.md",
"line_start": 76,
"line_end": 80
},
{
"file": "SKILL.md",
"line_start": 80,
"line_end": 84
},
{
"file": "SKILL.md",
"line_start": 84,
"line_end": 87
},
{
"file": "SKILL.md",
"line_start": 87,
"line_end": 92
},
{
"file": "SKILL.md",
"line_start": 92,
"line_end": 99
},
{
"file": "SKILL.md",
"line_start": 99,
"line_end": 105
},
{
"file": "SKILL.md",
"line_start": 105,
"line_end": 111
},
{
"file": "SKILL.md",
"line_start": 111,
"line_end": 111
},
{
"file": "SKILL.md",
"line_start": 112,
"line_end": 116
},
{
"file": "SKILL.md",
"line_start": 116,
"line_end": 116
},
{
"file": "SKILL.md",
"line_start": 117,
"line_end": 124
},
{
"file": "SKILL.md",
"line_start": 124,
"line_end": 129
},
{
"file": "SKILL.md",
"line_start": 129,
"line_end": 135
},
{
"file": "SKILL.md",
"line_start": 135,
"line_end": 136
},
{
"file": "SKILL.md",
"line_start": 136,
"line_end": 139
},
{
"file": "SKILL.md",
"line_start": 139,
"line_end": 139
},
{
"file": "SKILL.md",
"line_start": 140,
"line_end": 144
},
{
"file": "SKILL.md",
"line_start": 144,
"line_end": 147
},
{
"file": "SKILL.md",
"line_start": 147,
"line_end": 151
},
{
"file": "SKILL.md",
"line_start": 151,
"line_end": 161
},
{
"file": "SKILL.md",
"line_start": 161,
"line_end": 166
},
{
"file": "SKILL.md",
"line_start": 166,
"line_end": 167
},
{
"file": "SKILL.md",
"line_start": 167,
"line_end": 174
},
{
"file": "SKILL.md",
"line_start": 174,
"line_end": 174
},
{
"file": "SKILL.md",
"line_start": 175,
"line_end": 178
},
{
"file": "SKILL.md",
"line_start": 178,
"line_end": 179
},
{
"file": "SKILL.md",
"line_start": 179,
"line_end": 179
},
{
"file": "SKILL.md",
"line_start": 188,
"line_end": 189
},
{
"file": "SKILL.md",
"line_start": 189,
"line_end": 190
}
]
}
],
"static_findings": [
{
"id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 17,
"line_end": 17,
"snippet": "- Lesson teaches how to create skills → Check `.claude/skills/` structure"
},
{
"id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 18,
"line_end": 18,
"snippet": "- Lesson teaches how to write subagents → Check `.claude/agents/` structure"
},
{
"id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 19,
"line_end": 19,
"snippet": "- Lesson teaches ADR format → Check `specs/*/adrs/` structure"
},
{
"id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 20,
"line_end": 20,
"snippet": "- Lesson teaches PHR format → Check `history/prompts/` structure"
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 21,
"line_end": 21,
"snippet": "- Lesson teaches specification format → Check `specs/*/spec.md` structure"
},
{
"id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 32,
"line_end": 32,
"snippet": "| **Skills** | `.claude/skills/<name>/SKILL.md` | Directory structure, YAML frontmatter with `name`,"
},
{
"id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 33,
"line_end": 33,
"snippet": "| **Subagents** | `.claude/agents/<name>.md` | YAML frontmatter with `name`, `description`, `model`,"
},
{
"id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 34,
"line_end": 34,
"snippet": "| **ADRs** | `specs/<feature>/adrs/adr-*.md` | Numbered files, standard ADR structure |"
},
{
"id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 35,
"line_end": 35,
"snippet": "| **PHRs** | `history/prompts/<stage>/` | Template from `.specify/templates/phr-template.prompt.md` "
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 36,
"line_end": 36,
"snippet": "| **Specifications** | `specs/<feature>/spec.md` | Sections: Overview, User Stories, FRs, SCs, Evals"
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 37,
"line_end": 37,
"snippet": "| **Commands** | `.claude/commands/*.md` | YAML frontmatter, step-by-step phases |"
},
{
"id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 47,
"line_end": 52,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 52,
"line_end": 58,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 58,
"line_end": 70,
"snippet": "```bash"
},
{
"id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 70,
"line_end": 76,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 76,
"line_end": 80,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 80,
"line_end": 84,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 84,
"line_end": 87,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 87,
"line_end": 92,
"snippet": "```yaml"
},
{
"id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 92,
"line_end": 99,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:99:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 99,
"line_end": 105,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 105,
"line_end": 111,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 111,
"line_end": 111,
"snippet": "- [ ] Includes YAML frontmatter with `name` and `description`"
},
{
"id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 112,
"line_end": 116,
"snippet": "- [ ] `description` starts with \"This skill should be used when...\""
},
{
"id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 116,
"line_end": 116,
"snippet": "- [ ] Includes YAML frontmatter with `name`, `description`, `model`"
},
{
"id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 117,
"line_end": 124,
"snippet": "- [ ] Includes `skills` array (can be empty)"
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 124,
"line_end": 129,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 129,
"line_end": 135,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 135,
"line_end": 136,
"snippet": "**Issue**: Shows flat file `.claude/skills/my-skill.md`"
},
{
"id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 136,
"line_end": 139,
"snippet": "**Canonical**: Directory structure `.claude/skills/my-skill/SKILL.md`"
},
{
"id": "external_commands:SKILL.md:139:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 139,
"line_end": 139,
"snippet": "1. Line 45: Change `.claude/skills/my-skill.md` to `.claude/skills/my-skill/SKILL.md`"
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 140,
"line_end": 144,
"snippet": "2. Line 52: Update example to show directory creation with `mkdir`"
},
{
"id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 144,
"line_end": 147,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 147,
"line_end": 151,
"snippet": "```markdown"
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 151,
"line_end": 161,
"snippet": "**Canonical Source**: `.claude/skills/session-intelligence-harvester/SKILL.md`"
},
{
"id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 161,
"line_end": 166,
"snippet": "```"
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 166,
"line_end": 167,
"snippet": "**Wrong**: `.claude/skills/my-skill.md`"
},
{
"id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 167,
"line_end": 174,
"snippet": "**Right**: `.claude/skills/my-skill/SKILL.md`"
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 174,
"line_end": 174,
"snippet": "**Wrong**: `skill.md`, `index.md`, `README.md`"
},
{
"id": "external_commands:SKILL.md:175:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 175,
"line_end": 178,
"snippet": "**Right**: `SKILL.md` (uppercase)"
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 178,
"line_end": 179,
"snippet": "**Wrong**: Only `name` in frontmatter"
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 179,
"line_end": 179,
"snippet": "**Right**: Both `name` and `description` (description starts with \"This skill should be used when..."
},
{
"id": "external_commands:SKILL.md:188:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 188,
"line_end": 189,
"snippet": "- `chapter-planner` - Check during lesson planning phase"
},
{
"id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
"category": "external_commands",
"severity": "medium",
"pattern": "Ruby/shell backtick execution",
"file": "SKILL.md",
"line_start": 189,
"line_end": 190,
"snippet": "- `content-implementer` - Verify before implementation"
}
],
"finding_verdicts": [
{
"id": "external_commands:SKILL.md:17:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:19:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:20:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:21:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:32:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:33:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:34:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:35:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:36:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:37:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:47:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:52:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:58:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:70:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:76:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:80:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:87:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:92:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:99:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:105:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:111:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:112:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:116:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:117:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:129:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:135:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:139:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:140:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:144:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:151:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:161:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:166:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:167:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:175:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:178:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:179:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:188:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
},
{
"id": "external_commands:SKILL.md:189:ruby-shell-backtick-execution",
"verdict": "false_positive",
"confidence": 0.97,
"reason": "The flagged text is Markdown inline code or a fenced documentation example in SKILL.md, not Ruby backtick execution. It does not execute commands or interpolate user input."
}
],
"semantic_findings": [],
"critical_findings": [],
"high_findings": [],
"medium_findings": [],
"low_findings": [],
"dangerous_patterns": [],
"files_scanned": 1,
"total_lines": 221,
"audit_model": "codex",
"audited_at": "2026-07-05T14:46:29.200Z",
"agent_auto_install_policy": "allowed",
"manual_install_policy": "allowed"
},
"content": {
"user_title": "Verify Canonical Formats",
"value_statement": "Format drift makes lessons and documentation teach the wrong structure. This skill checks content against canonical sources before publication.",
"seo_keywords": [
"Claude",
"Codex",
"Claude Code",
"canonical format checker",
"format drift",
"documentation review",
"skill format",
"subagent format",
"ADR template",
"specification validation"
],
"actual_capabilities": [
"Identifies content that teaches skills, subagents, ADRs, PHRs, specifications, or commands.",
"Locates the expected canonical source for each supported pattern.",
"Extracts required format elements from canonical sources.",
"Compares lessons or documentation against the canonical format.",
"Reports specific drift findings and required fixes when content differs from the source."
],
"limitations": [
"Requires access to canonical source files in the workspace.",
"Does not validate runtime behavior or platform execution.",
"Covers the listed platform patterns, not every documentation convention.",
"Depends on the reviewer to apply suggested fixes."
],
"use_cases": [
{
"title": "Review Training Lessons",
"description": "Check lessons that teach platform patterns before they reach students or internal users.",
"target_user": "Technical curriculum author"
},
{
"title": "Audit Documentation Updates",
"description": "Compare documentation changes with canonical examples before approving a pull request.",
"target_user": "Documentation reviewer"
},
{
"title": "Prevent Agent Format Drift",
"description": "Verify that AI-generated guidance follows the current workspace format for skills and agents.",
"target_user": "AI coding assistant operator"
}
],
"prompt_templates": [
{
"title": "Check Skill Format",
"scenario": "Beginner review of one lesson.",
"prompt": "Check this lesson for skill format drift. Identify the canonical source, compare the taught structure, and list required fixes."
},
{
"title": "Verify Multiple Patterns",
"scenario": "Review documentation that covers several platform objects.",
"prompt": "Review this documentation for skill, subagent, and command format consistency. Use canonical sources from the workspace before approving it."
},
{
"title": "Audit Before Publication",
"scenario": "Pre-publication review for a chapter or guide.",
"prompt": "Audit this chapter for canonical format drift across skills, ADRs, PHRs, specifications, and commands. Report compliance and blocking issues."
},
{
"title": "Create Drift Checklist",
"scenario": "Advanced workflow design for repeat reviews.",
"prompt": "Build a validation checklist from the canonical sources for this platform area. Include exact requirements and reviewer signoff criteria."
}
],
"output_examples": [
{
"input": "Review a lesson that teaches users to create a Claude Code skill.",
"output": "The review identifies the canonical skill directory, checks required frontmatter, and reports that the lesson uses the wrong flat-file pattern."
},
{
"input": "Audit documentation that explains custom commands and subagents.",
"output": "The audit separates each pattern, cites the matching canonical source, and lists which sections are compliant or need correction."
},
{
"input": "Prepare a final publication check for a platform tutorial.",
"output": "The result confirms checked sources, summarizes drift risks, and gives specific edits needed before release."
}
],
"best_practices": [
"Read the canonical source before writing or approving format guidance.",
"Record the exact pattern being taught before comparing examples.",
"Give line-specific fixes when drift is found."
],
"anti_patterns": [
"Approving examples without checking the current canonical source.",
"Mixing formats from different platform objects in one lesson.",
"Giving vague feedback that does not identify the required format."
],
"faq": [
{
"question": "What problem does this skill solve?",
"answer": "It prevents lessons and documentation from teaching formats that conflict with canonical platform sources."
},
{
"question": "Which formats can it check?",
"answer": "It covers skills, subagents, ADRs, PHRs, specifications, and command documentation listed in the skill."
},
{
"question": "Does it modify files automatically?",
"answer": "No. It identifies drift and gives specific fixes for a reviewer or author to apply."
},
{
"question": "Does it require workspace access?",
"answer": "Yes. It needs access to canonical examples so it can compare content against current source formats."
},
{
"question": "Can it be used with Claude, Codex, and Claude Code?",
"answer": "Yes. The report lists support for Claude, Codex, and Claude Code workflows."
},
{
"question": "Is it a security scanner?",
"answer": "No. It is a documentation consistency skill, not a runtime security analysis tool."
}
]
},
"file_structure": [
{
"name": "SKILL.md",
"type": "file",
"path": "SKILL.md",
"lines": 221
}
]
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |