Skip to content

Conversation

@JacobPEvans
Copy link
Owner

@JacobPEvans JacobPEvans commented Feb 8, 2026

Summary

Enhances the markdown validator plugin with two critical improvements:

  • Skip Logic: Automatically skips validation for home dotfiles and .claude directories
  • MD013 Fallback: Guarantees 160-character line limit even when plugin config is unavailable

Changes

1. Skip Logic for Dotfiles and .claude Directories

  • Skips all files in home directory dotfiles/dotdirs (~/.config/, ~/.local/, ~/.claude/)
  • Skips all files within any .claude directory at any level
  • Uses path expansion and pattern matching for reliable detection

2. MD013 Fallback with Guaranteed 160-Character Limit

  • Enhanced config resolution with 4-tier fallback chain
  • Creates temporary inline config when no other config is available
  • Ensures MD013=160 is always enforced (prevents 80-char default)
  • Handles edge cases where CLAUDE_PLUGIN_ROOT is unset or config is missing

3. Documentation Updates

  • Added "Skip Behavior" section documenting automatic skips
  • Updated "Markdownlint Config Resolution" to include guaranteed fallback
  • Clear explanation of 4-tier config resolution chain

4. Version Bump

  • Updated from 1.0.0 to 1.1.0 (minor version for new features)

Test Plan

  • Skip logic works for ~/.config/test.md
  • Skip logic works for ~/git/repo/.claude/test.md
  • MD013 fallback creates temporary config when plugin config unavailable
  • Normal validation still works for regular markdown files
  • Config resolution priority order maintained
  • Documentation accurately reflects new behavior

Impact

  • Eliminates false positive validation errors in system/config files
  • Ensures consistent 160-character line limits across all environments
  • Maintains backward compatibility with existing configs

🤖 Generated with Claude Code


Important

Enhances markdown validator with skip logic for dotfiles and .claude directories, and a fallback for MD013 configuration.

  • Behavior:
    • Skips validation for files in home dotfiles/dotdirs and .claude directories in validate-markdown.sh.
    • Ensures a 160-character line limit with a fallback config in validate-markdown.sh.
  • Configuration:
    • Adds a 4-tier config resolution chain in validate-markdown.sh.
    • Updates config/.markdownlint-cli2.yaml to set code_block_line_length to 120.
  • Documentation:
    • Adds "Skip Behavior" and updates "Markdownlint Config Resolution" in markdown-validator/README.md.
  • Misc:
    • Version bump from 1.0.0 to 1.1.0 in plugin.json.

This description was created by Ellipsis for e21caf9. You can customize this summary. It will automatically update as commits are pushed.

Add two improvements to the markdown validator:

1. Skip Logic: Automatically skip validation for:
   - Home directory dotfiles/dotdirs (~/.config/, ~/.local/, ~/.claude/)
   - Any .claude directory at any level in any project
   - Prevents validation errors in system/config files

2. MD013 Fallback: Add guaranteed fallback config when plugin config unavailable:
   - Creates temporary inline config with MD013=160
   - Ensures 160-character line limit is always enforced
   - Prevents fallback to markdownlint's 80-character default
   - Handles edge cases where CLAUDE_PLUGIN_ROOT is unset or config missing

Version bumped to 1.1.0 with updated documentation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings February 8, 2026 16:07
Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed everything up to d5144e2 in 7 seconds. Click for details.
  • Reviewed 105 lines of code in 3 files
  • Skipped 0 files when reviewing.
  • Skipped posting 0 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.

Workflow ID: wflow_8YySbWv50sBN6axi

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

@gemini-code-assist
Copy link

Summary of Changes

Hello @JacobPEvans, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request significantly improves the markdown validator plugin by introducing robust skip logic and a guaranteed fallback for line length enforcement. The changes aim to reduce false positive validation errors in system-related files and ensure consistent adherence to a 160-character line limit across all environments, thereby enhancing the plugin's reliability and user experience without compromising existing configurations.

Highlights

  • Enhanced Skip Logic: The validator now automatically skips files in home directory dotfiles/dotdirs (e.g., ~/.config/, ~/.local/) and any .claude directories, preventing irrelevant validation errors.
  • Guaranteed MD013 Enforcement: A new 4-tier configuration resolution ensures that the 160-character line limit (MD013) is always enforced, even when other configurations are unavailable, by creating a temporary inline config.
  • Updated Documentation: The README.md has been updated to reflect the new skip behaviors and the detailed 4-tier markdownlint configuration resolution process.
  • Version Increment: The plugin version has been updated from 1.0.0 to 1.1.0 to reflect the introduction of these new features.
Changelog
  • markdown-validator/.claude-plugin/plugin.json
    • Updated the plugin version from "1.0.0" to "1.1.0".
  • markdown-validator/README.md
    • Added a new "Skip Behavior" section detailing automatic file exclusions for home dotfiles/dotdirs and .claude directories.
    • Expanded the "Markdownlint Config Resolution" section to include a new "Guaranteed fallback" tier, ensuring the MD013 rule is always applied.
  • markdown-validator/scripts/validate-markdown.sh
    • Implemented new conditional checks to skip validation for files located in home dotfiles/dotdirs (e.g., ~/.config/, ~/.local/) and any .claude directories.
    • Enhanced the markdownlint configuration loading logic to include a fallback mechanism: if no other configuration is found, a temporary configuration file is created on-the-fly to enforce the MD013 rule with a 160-character line limit.
Activity
  • No specific activity (comments, reviews, etc.) was provided in the context for this pull request.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Update code_block_line_length from 160 to 120 to keep code concise.

Changes:
- Temporary fallback config in validation script
- Bundled plugin config file
- Documentation example

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 78aa051 in 8 seconds. Click for details.
  • Reviewed 48 lines of code in 3 files
  • Skipped 0 files when reviewing.
  • Skipped posting 0 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.

Workflow ID: wflow_Lwohplk4l1eQdWGe

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request introduces useful enhancements to the markdown validator, including skip logic for dotfiles and a robust fallback for the line-length rule. The changes are well-documented in the README. However, I found a high-severity bug in the temporary file cleanup logic that will lead to orphaned files on the system. My review includes a specific fix for this issue.

Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Enhances the markdown-validator Claude Code plugin to reduce unwanted validations and to enforce a consistent MD013 line-length rule even when configs are missing/unavailable.

Changes:

  • Add early skip logic for home-directory dotfiles/dotdirs and any .claude directories.
  • Add a 4th-tier markdownlint config fallback by generating a temporary inline config enforcing MD013=160.
  • Update plugin documentation and bump plugin version to 1.1.0.

Reviewed changes

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

File Description
markdown-validator/scripts/validate-markdown.sh Adds skip rules and introduces a temp-config fallback for markdownlint-cli2 config resolution.
markdown-validator/README.md Documents skip behavior and the 4-tier config resolution chain including the guaranteed fallback.
markdown-validator/.claude-plugin/plugin.json Bumps plugin version from 1.0.0 to 1.1.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Implement automatic Nix flake updates when changes merge to main:
- Add trigger workflow that sends repository_dispatch to nix repo
- Uses generic upstream-repo-updated event type for scalability
- Requires WORKFLOW_DISPATCH_PAT organization secret
- Document setup instructions and reusable pattern in README

This ensures downstream nix repository immediately pulls in plugin
updates instead of waiting for daily scheduled updates.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed 5b5eac3 in 8 seconds. Click for details.
  • Reviewed 148 lines of code in 2 files
  • Skipped 0 files when reviewing.
  • Skipped posting 0 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.

Workflow ID: wflow_4vmhQwdZCtdNGJHa

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

Update workflow and documentation to use the existing organization
secret GH_PAT_WORKFLOW_DISPATCH instead of WORKFLOW_DISPATCH_PAT.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Copy link

@ellipsis-dev ellipsis-dev bot left a comment

Choose a reason for hiding this comment

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

Important

Looks good to me! 👍

Reviewed e21caf9 in 8 seconds. Click for details.
  • Reviewed 35 lines of code in 2 files
  • Skipped 0 files when reviewing.
  • Skipped posting 0 draft comments. View those below.
  • Modify your settings and rules to customize what types of comments Ellipsis leaves. And don't forget to react with 👍 or 👎 to teach Ellipsis.

Workflow ID: wflow_FOTU9vxtBtKxG404

You can customize Ellipsis by changing your verbosity settings, reacting with 👍 or 👎, replying to comments, or adding code review rules.

@JacobPEvans JacobPEvans merged commit 77cd37b into main Feb 8, 2026
5 checks passed
@JacobPEvans JacobPEvans deleted the feat/markdown-validator-skip-logic-md013-fallback branch February 8, 2026 18:02
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.

1 participant