Skip to content

aiskillstore/marketplace / skills/46ki75/markdown

markdown

Verified

Markdown linting and automated fixing using markdownlint-cli2. Use when Claude needs to: (1) Check markdown files for style issues, (2) Fix markdown formatting problems, (3) Ensure markdown follows best practices, (4) Validate markdown documents, or (5) Apply consistent markdown styling

FileKindSize
SKILL.mdskill md6.1 KB
skill-report.jsonconfig38.4 KB

skill-report.json

View on GitHub
{
  "schema_version": "2.0",
  "meta": {
    "generated_at": "2026-07-04T17:36:51.608Z",
    "slug": "46ki75-markdown",
    "source_url": "https://github.com/46ki75/skills/tree/main/public/markdown",
    "source_ref": "main",
    "model": "codex",
    "analysis_version": "3.0.0",
    "source_type": "community",
    "content_hash": "3a09c860dc392084a42269415f279c639984684aff73d64f9e0295339208929c",
    "tree_hash": "a27822a7bfa76b0ab9af97e571c48684c6281abcc9b2263d0d3e47d0e96aca20",
    "provenance": {
      "model_requested": "gpt-5.5:high",
      "model_effective": "codex:gpt-5.5:high",
      "fallback_chain": [
        {
          "agent": "codex",
          "model": "gpt-5.5",
          "effort": "high",
          "outcome": "success"
        }
      ],
      "analysis_version": "3.0.0"
    }
  },
  "skill": {
    "name": "markdown",
    "description": "Markdown linting and automated fixing for documentation files using markdownlint-cli2. It guides agents through checks, safe fixes, manual cleanup, configuration, and final reporting.",
    "summary": "Lint, fix, and validate Markdown documents with markdownlint-cli2 guidance.",
    "icon": "📦",
    "version": "1.0.0",
    "author": "46ki75",
    "license": "MIT",
    "tags": [
      "markdown",
      "linting",
      "documentation",
      "formatting",
      "markdownlint"
    ],
    "supported_tools": [
      "claude",
      "codex",
      "claude-code"
    ],
    "risk_factors": [
      "external_commands",
      "network"
    ],
    "category": "documentation"
  },
  "security_audit": {
    "risk_level": "safe",
    "is_blocked": false,
    "safe_to_publish": true,
    "analysis_status": "ok",
    "summary": "The static analyzer matched Markdown fences and inline code as Ruby backtick execution. Review found documented markdownlint-cli2 usage and a public documentation URL, with no prompt injection, data exfiltration, or arbitrary command construction in SKILL.md.",
    "remediation": [
      {
        "issue": "Broad auto-fix examples can modify many Markdown files when used without scope confirmation.",
        "suggestion": "Add guidance to confirm target paths before running recursive or multi-file auto-fix commands.",
        "severity": "low"
      },
      {
        "issue": "Command examples do not explicitly mention safe handling of user-provided file paths.",
        "suggestion": "Add a note to quote or validate paths before passing them to shell commands.",
        "severity": "low"
      }
    ],
    "risk_factor_evidence": [
      {
        "factor": "external_commands",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 13,
            "line_end": 18
          },
          {
            "file": "SKILL.md",
            "line_start": 18,
            "line_end": 25
          },
          {
            "file": "SKILL.md",
            "line_start": 25,
            "line_end": 40
          },
          {
            "file": "SKILL.md",
            "line_start": 40,
            "line_end": 44
          },
          {
            "file": "SKILL.md",
            "line_start": 44,
            "line_end": 53
          },
          {
            "file": "SKILL.md",
            "line_start": 53,
            "line_end": 64
          },
          {
            "file": "SKILL.md",
            "line_start": 64,
            "line_end": 68
          },
          {
            "file": "SKILL.md",
            "line_start": 68,
            "line_end": 75
          },
          {
            "file": "SKILL.md",
            "line_start": 75,
            "line_end": 77
          },
          {
            "file": "SKILL.md",
            "line_start": 77,
            "line_end": 84
          },
          {
            "file": "SKILL.md",
            "line_start": 84,
            "line_end": 89
          },
          {
            "file": "SKILL.md",
            "line_start": 89,
            "line_end": 102
          },
          {
            "file": "SKILL.md",
            "line_start": 102,
            "line_end": 120
          },
          {
            "file": "SKILL.md",
            "line_start": 120,
            "line_end": 124
          },
          {
            "file": "SKILL.md",
            "line_start": 124,
            "line_end": 130
          },
          {
            "file": "SKILL.md",
            "line_start": 130,
            "line_end": 134
          },
          {
            "file": "SKILL.md",
            "line_start": 134,
            "line_end": 136
          },
          {
            "file": "SKILL.md",
            "line_start": 136,
            "line_end": 142
          },
          {
            "file": "SKILL.md",
            "line_start": 142,
            "line_end": 146
          },
          {
            "file": "SKILL.md",
            "line_start": 146,
            "line_end": 147
          },
          {
            "file": "SKILL.md",
            "line_start": 147,
            "line_end": 148
          },
          {
            "file": "SKILL.md",
            "line_start": 148,
            "line_end": 149
          },
          {
            "file": "SKILL.md",
            "line_start": 149,
            "line_end": 150
          },
          {
            "file": "SKILL.md",
            "line_start": 150,
            "line_end": 154
          },
          {
            "file": "SKILL.md",
            "line_start": 154,
            "line_end": 155
          },
          {
            "file": "SKILL.md",
            "line_start": 155,
            "line_end": 156
          },
          {
            "file": "SKILL.md",
            "line_start": 156,
            "line_end": 156
          },
          {
            "file": "SKILL.md",
            "line_start": 157,
            "line_end": 157
          },
          {
            "file": "SKILL.md",
            "line_start": 163,
            "line_end": 174
          },
          {
            "file": "SKILL.md",
            "line_start": 174,
            "line_end": 192
          },
          {
            "file": "SKILL.md",
            "line_start": 192,
            "line_end": 208
          },
          {
            "file": "SKILL.md",
            "line_start": 208,
            "line_end": 214
          },
          {
            "file": "SKILL.md",
            "line_start": 214,
            "line_end": 223
          },
          {
            "file": "SKILL.md",
            "line_start": 223,
            "line_end": 227
          },
          {
            "file": "SKILL.md",
            "line_start": 227,
            "line_end": 231
          },
          {
            "file": "SKILL.md",
            "line_start": 231,
            "line_end": 235
          },
          {
            "file": "SKILL.md",
            "line_start": 235,
            "line_end": 236
          }
        ]
      },
      {
        "factor": "network",
        "evidence": [
          {
            "file": "SKILL.md",
            "line_start": 268,
            "line_end": 268
          }
        ]
      }
    ],
    "static_findings": [
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 13,
        "line_end": 18,
        "snippet": "```text"
      },
      {
        "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": 25,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 25,
        "line_end": 40,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 40,
        "line_end": 44,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 44,
        "line_end": 53,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 53,
        "line_end": 64,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 64,
        "line_end": 68,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 68,
        "line_end": 75,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 75,
        "line_end": 77,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 77,
        "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": 89,
        "snippet": "```markdown"
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 89,
        "line_end": 102,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 102,
        "line_end": 120,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 120,
        "line_end": 124,
        "snippet": "```"
      },
      {
        "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": 130,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 130,
        "line_end": 134,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 134,
        "line_end": 136,
        "snippet": "Create `.markdownlint.json` to customize rules:"
      },
      {
        "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": 142,
        "snippet": "```json"
      },
      {
        "id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 142,
        "line_end": 146,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:146:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 146,
        "line_end": 147,
        "snippet": "- `\"MD013\": false` - Disable line length checking"
      },
      {
        "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": 148,
        "snippet": "- `\"MD013\": { \"line_length\": 120 }` - Increase limit to 120"
      },
      {
        "id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 148,
        "line_end": 149,
        "snippet": "- `\"MD013\": { \"code_blocks\": false }` - Exclude code blocks"
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 149,
        "line_end": 150,
        "snippet": "- `\"MD033\": false` - Allow HTML"
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 150,
        "line_end": 154,
        "snippet": "- `\"MD041\": false` - Don't require first line header"
      },
      {
        "id": "external_commands:SKILL.md:154:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 154,
        "line_end": 155,
        "snippet": "1. `.markdownlint-cli2.jsonc`"
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 155,
        "line_end": 156,
        "snippet": "2. `.markdownlint-cli2.yaml`"
      },
      {
        "id": "external_commands:SKILL.md:156:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 156,
        "line_end": 156,
        "snippet": "3. `.markdownlint.jsonc` / `.markdownlint.json`"
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 157,
        "line_end": 157,
        "snippet": "4. `.markdownlint.yaml` / `.markdownlint.yml`"
      },
      {
        "id": "external_commands:SKILL.md:163:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 163,
        "line_end": 174,
        "snippet": "```text"
      },
      {
        "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": 192,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:192:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 192,
        "line_end": 208,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 208,
        "line_end": 214,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:214:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 214,
        "line_end": 223,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:223:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 223,
        "line_end": 227,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 227,
        "line_end": 231,
        "snippet": "```bash"
      },
      {
        "id": "external_commands:SKILL.md:231:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 231,
        "line_end": 235,
        "snippet": "```"
      },
      {
        "id": "external_commands:SKILL.md:235:ruby-shell-backtick-execution",
        "category": "external_commands",
        "severity": "medium",
        "pattern": "Ruby/shell backtick execution",
        "file": "SKILL.md",
        "line_start": 235,
        "line_end": 236,
        "snippet": "- Disable in config: `\"MD013\": false`"
      },
      {
        "id": "network:SKILL.md:268:hardcoded-url",
        "category": "network",
        "severity": "low",
        "pattern": "Hardcoded URL",
        "file": "SKILL.md",
        "line_start": 268,
        "line_end": 268,
        "snippet": "Full rule documentation: <https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md>"
      }
    ],
    "finding_verdicts": [
      {
        "id": "external_commands:SKILL.md:13:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This range is a workflow example with literal markdownlint-cli2 commands. It documents the intended linter workflow and does not execute Ruby backticks or construct commands dynamically."
      },
      {
        "id": "external_commands:SKILL.md:18:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The detected backticks are Markdown fences or inline code markers in documentation. They do not represent Ruby shell backtick execution or executable code in the skill."
      },
      {
        "id": "external_commands:SKILL.md:25:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This range contains bash examples for markdownlint-cli2 with fixed command names and typical file arguments. The backticks are Markdown fencing, and no hidden shell expansion or dynamic command construction is present."
      },
      {
        "id": "external_commands:SKILL.md:40:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The detected backticks are Markdown fences or inline code markers in documentation. They do not represent Ruby shell backtick execution or executable code in the skill."
      },
      {
        "id": "external_commands:SKILL.md:44:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This range documents example file paths and an output copy step for processed Markdown files. It is visible operational guidance, not Ruby backtick execution or secret exfiltration."
      },
      {
        "id": "external_commands:SKILL.md:53:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.94,
        "reason": "The detected backticks are Markdown fences or inline code markers in documentation. They do not represent Ruby shell backtick execution or executable code in the skill."
      },
      {
        "id": "external_commands:SKILL.md:64:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:68:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:75:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:77:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:84:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:89:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:102:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This range shows a step-by-step uploaded-file lint workflow using fixed markdownlint-cli2 and copy commands. It is expected behavior for the skill and lacks arbitrary command interpolation."
      },
      {
        "id": "external_commands:SKILL.md:120:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:124:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This range shows creating and linting a new Markdown document with fixed example paths. The snippet is documentation, not executable backtick syntax inside the skill."
      },
      {
        "id": "external_commands:SKILL.md:130:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:134:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:136:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:142:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:146:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:147:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:148:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:149:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:150:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:154:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:155:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:156:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:157:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "external_commands:SKILL.md:163:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:174:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:192:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This range contains manual edit examples and comments for common lint fixes. It does not invoke Ruby backticks and the pseudo str_replace examples are not shell execution."
      },
      {
        "id": "external_commands:SKILL.md:208:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:214:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This troubleshooting range includes visible file checks and markdownlint-cli2 examples. The commands are diagnostic guidance with literal executables, not hidden command execution."
      },
      {
        "id": "external_commands:SKILL.md:223:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:227:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.84,
        "reason": "This troubleshooting range writes a local markdownlint config and reruns the linter. The command is documented configuration guidance, not arbitrary or concealed shell execution."
      },
      {
        "id": "external_commands:SKILL.md:231:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range contains Markdown examples used to explain lint fixes. The backticks are documentation formatting and do not execute commands."
      },
      {
        "id": "external_commands:SKILL.md:235:ruby-shell-backtick-execution",
        "verdict": "false_positive",
        "confidence": 0.95,
        "reason": "The range documents markdownlint configuration names or JSON rule examples. These inline backticks are formatting markers, not executable shell or Ruby backtick usage."
      },
      {
        "id": "network:SKILL.md:268:hardcoded-url",
        "verdict": "false_positive",
        "confidence": 0.96,
        "reason": "The hardcoded URL is a public markdownlint rule documentation link. It is not used for network access, callbacks, tracking, or data exfiltration."
      }
    ],
    "semantic_findings": [],
    "critical_findings": [],
    "high_findings": [],
    "medium_findings": [],
    "low_findings": [],
    "dangerous_patterns": [],
    "files_scanned": 1,
    "total_lines": 269,
    "audit_model": "codex",
    "audited_at": "2026-07-04T17:36:51.608Z",
    "agent_auto_install_policy": "allowed",
    "manual_install_policy": "allowed"
  },
  "content": {
    "user_title": "Lint and Fix Markdown Documents",
    "value_statement": "Markdown files often drift from project style rules and become harder to maintain. This skill guides Claude, Codex, and Claude Code through markdownlint-cli2 checks, fixes, and clear reporting.",
    "seo_keywords": [
      "Claude",
      "Codex",
      "Claude Code",
      "markdown linting",
      "markdownlint-cli2",
      "markdown formatting",
      "documentation quality",
      "Markdown validation",
      "automated fixes",
      "AI documentation tools"
    ],
    "actual_capabilities": [
      "Guides markdownlint-cli2 auto-fix runs for one or more Markdown files.",
      "Checks remaining Markdown lint errors after automated formatting.",
      "Explains common markdownlint rules such as heading levels, long lines, and code fences.",
      "Applies manual cleanup guidance for issues auto-fix cannot resolve.",
      "Helps create or adjust markdownlint configuration for project needs.",
      "Summarizes initial errors, automated fixes, manual edits, and final validation results."
    ],
    "limitations": [
      "Requires markdownlint-cli2 to be installed in the execution environment.",
      "Can modify files when auto-fix is used, so changes should be reviewed.",
      "Cannot infer every project writing convention without user guidance.",
      "Does not validate rendered output, links, or factual accuracy beyond lint rules."
    ],
    "use_cases": [
      {
        "title": "Clean Pull Request Documentation",
        "description": "Lint README updates, fix common style issues, and report what changed before review.",
        "target_user": "Software engineer"
      },
      {
        "title": "Standardize Documentation Sets",
        "description": "Apply consistent markdownlint rules across guides, tutorials, and reference pages.",
        "target_user": "Documentation maintainer"
      },
      {
        "title": "Prepare User-Facing Guides",
        "description": "Find heading, spacing, and formatting issues before publishing Markdown content.",
        "target_user": "Technical writer"
      }
    ],
    "prompt_templates": [
      {
        "title": "Check One File",
        "scenario": "Beginner validation of a single Markdown document.",
        "prompt": "Check this Markdown file for lint issues. Explain the main problems and suggest safe fixes before changing it."
      },
      {
        "title": "Auto-Fix and Report",
        "scenario": "Routine cleanup for a draft or README.",
        "prompt": "Run the Markdown auto-fix workflow on this file, then report the initial errors, remaining issues, and final result."
      },
      {
        "title": "Fix Manual Lint Issues",
        "scenario": "Intermediate cleanup after auto-fix leaves structural problems.",
        "prompt": "Review the remaining markdownlint errors. Fix heading hierarchy, emphasis-as-heading, and line wrapping issues while preserving meaning."
      },
      {
        "title": "Tune Project Rules",
        "scenario": "Advanced configuration for a repository with custom style rules.",
        "prompt": "Review this project documentation style. Propose a markdownlint configuration and apply it to the selected files with a change summary."
      }
    ],
    "output_examples": [
      {
        "input": "A README has multiple top-level headings and inconsistent blank lines.",
        "output": [
          "The report lists the initial lint errors and the rules involved.",
          "The final summary says which headings were adjusted and confirms a clean lint result."
        ]
      },
      {
        "input": "An API guide needs consistent line length and code block language labels.",
        "output": [
          "The guide is reformatted where safe, with unresolved style decisions called out clearly.",
          "The summary separates automatic fixes from manual edits for easier review."
        ]
      },
      {
        "input": "A legacy document uses embedded HTML and long URLs.",
        "output": "The result recommends a project-specific configuration and explains which rules should stay enabled or disabled."
      }
    ],
    "best_practices": [
      "Run lint checks before and after edits so the final state is clear.",
      "Review auto-fix changes when files contain generated content or complex examples.",
      "Use a project configuration when documentation intentionally differs from default rules."
    ],
    "anti_patterns": [
      "Running broad auto-fix commands across a repository without confirming scope.",
      "Disabling lint rules globally when only one document needs an exception.",
      "Changing document hierarchy only to satisfy lint rules without checking meaning."
    ],
    "faq": [
      {
        "question": "What does this skill use to lint Markdown?",
        "answer": "It uses markdownlint-cli2 guidance to check files, apply safe fixes, and verify the result."
      },
      {
        "question": "Can it automatically fix every lint issue?",
        "answer": "No. Heading structure, emphasis used as headings, and long lines often need human judgment."
      },
      {
        "question": "Does it require local tooling?",
        "answer": "Yes. The environment must have markdownlint-cli2 available for command-based linting."
      },
      {
        "question": "Can it work with custom markdownlint rules?",
        "answer": "Yes. It can guide configuration changes for project rules such as line length and allowed HTML."
      },
      {
        "question": "Will it preserve document meaning?",
        "answer": "It aims to preserve meaning, but structural edits should be reviewed for important documents."
      },
      {
        "question": "Is it useful for generated documentation?",
        "answer": "Yes, but generated files may need relaxed rules or exclusions to avoid unwanted churn."
      }
    ]
  },
  "file_structure": [
    {
      "name": "SKILL.md",
      "type": "file",
      "path": "SKILL.md",
      "lines": 269
    }
  ]
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall