Skip to content

Comments

Fix markdown lint errors: add language specifiers and wrap bare URLs#3

Merged
hummbl-dev merged 4 commits intomainfrom
copilot/fix-markdown-lint-errors
Jan 3, 2026
Merged

Fix markdown lint errors: add language specifiers and wrap bare URLs#3
hummbl-dev merged 4 commits intomainfrom
copilot/fix-markdown-lint-errors

Conversation

Copy link
Contributor

Copilot AI commented Jan 3, 2026

CI failing on MD040 (missing code fence languages) and MD034 (bare URLs). All fenced code blocks now have explicit language specifiers, all bare URLs wrapped in angle brackets.

Changes

MD040: Added text language to 13 code blocks

  • sitrep-coordinator/SKILL.md (5 blocks): Authorization format, flow diagrams
  • transformation-workflow/SKILL.md (1 block): Decision tree flowchart
  • github-repository-architect/SKILL.md (6 blocks): Directory trees, CODEOWNERS format, branch rules, semver spec, commit conventions
  • mcp-server-developer/SKILL.md (1 block): Test output example

MD034: Wrapped 11 bare URLs in angle brackets

  • github-repository-architect/SKILL.md: Resources section (6 URLs)
  • mcp-server-developer/SKILL.md: Resources section (5 URLs)

Example fix:

-```
+```text
Agent A → SITREP → Agent B → SITREP → Agent C
-- **GitHub Docs**: https://docs.github.com
+- **GitHub Docs**: <https://docs.github.com>
Original prompt

The repository currently has markdown lint errors (MD040), which indicate that fenced code blocks are missing language specifiers. Specifically:

  1. In sitrep-coordinator/SKILL.md, at line 291:

    • Add a language specifier such as markdown, as the content within the code block appears to involve markdown formatting or examples. Change:

    Content here

    To:
    ```markdown
    # Content here
    
  2. In transformation-workflow/SKILL.md, at line 646:

    • Determine the proper language for the code block, which could be plaintext (if it contains plain flowchart-like content) or another relevant language. For example:
    ```plaintext
    START: What's your primary need?
    ... (flowchart content)
    

These updates need to be applied for all affected files and lines, ensuring that every fenced code block explicitly specifies a language. This will fix the markdown lint errors and allow the CI pipeline to pass.

This pull request was created from Copilot chat.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 3 commits January 3, 2026 20:25
…cifiers to code blocks

Co-authored-by: hummbl-dev <238336761+hummbl-dev@users.noreply.github.com>
…and wrap bare URLs

Co-authored-by: hummbl-dev <238336761+hummbl-dev@users.noreply.github.com>
Co-authored-by: hummbl-dev <238336761+hummbl-dev@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix markdown lint errors by adding language specifiers Fix markdown lint errors: add language specifiers and wrap bare URLs Jan 3, 2026
Copilot AI requested a review from hummbl-dev January 3, 2026 20:30
Copy link
Owner

@hummbl-dev hummbl-dev left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

approved

@hummbl-dev hummbl-dev marked this pull request as ready for review January 3, 2026 20:38
@hummbl-dev hummbl-dev merged commit 13e9e20 into main Jan 3, 2026
3 checks passed
@hummbl-dev hummbl-dev deleted the copilot/fix-markdown-lint-errors branch January 3, 2026 20:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants