content-linter
🥈SilverWelcome to Raz Kaplan corner of the web! As a seasoned marketer and startup strategist, I share my thoughts on growth, tech, and everything in between. Dive into my blog for insights on modern marketing, and discover the tailored services I offer to help technical founders build scalable go-to-market strategies. Let's make your growth
400Updated 2mo ago
Intermediate30min to implementmarketing
Saves ~10 min per use
Quick InstallView Source
git clone https://github.com/razkaplan/content-linter.gitWorks with:
Claude
Overview
About This Skill
Content Linter is a linting tool that automatically validates Markdown blog posts for technical SEO compliance, keyword usage, link health, heading structure, images, spelling, and readability. It runs as a CLI tool or integrates directly into GitHub Actions workflows for continuous content quality checks. The linter ensures each post includes required front matter (title, slug, description) and provides recommendations for internal/external links and image inclusion. It detects spelling errors with correction suggestions and exits with a non-zero status if any checks fail, making it ideal for blogs, technical documentation, and content-driven marketing teams.
How to Use
Install via pip and run the CLI with your posts directory and keywords file: `pip install . && content-linter --posts-dir _posts --keywords-file keywords.txt`. Alternatively, add the GitHub Action to your workflow YAML by referencing `razkpp/content-linter@v0` with your keywords file path.
Use Cases
Automated QA for Markdown blog posts in GitHub repositories
Continuous technical SEO validation in CI/CD workflows
Spelling and readability checks across content teams
Keyword and link health verification for blog content
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/razkaplan/content-linterRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Act as a content linter for my blog post about [TOPIC]. I want to ensure it follows best practices for [INDUSTRY] content. Check for: 1) SEO optimization, 2) readability, 3) engagement potential, and 4) alignment with [COMPANY] brand voice. Provide specific suggestions for improvement.
Example Output
# Content Linting Report ## SEO Optimization - **Keyword Usage**: The post mentions 'growth hacking' 5 times, which is good, but consider adding related terms like 'scalable growth' or 'startup marketing' to improve semantic relevance. - **Meta Description**: Currently missing. Suggest: 'Discover actionable growth hacking strategies for tech startups. Learn how to scale your user base efficiently with these proven tactics.' ## Readability - **Sentence Length**: Several sentences exceed 25 words. Break up complex sentences for better readability. - **Subheadings**: Add more subheadings to improve scannability. Consider adding 'Key Growth Hacking Tactics' and 'Measuring Success' sections. ## Engagement Potential - **Call-to-Action**: The post ends abruptly. Add a clear CTA like 'Ready to implement these growth hacking strategies? Book a consultation with me to discuss your startup's unique needs.' - **Interactive Elements**: Consider adding a poll or question to encourage reader engagement, e.g., 'Which growth hacking tactic have you found most effective? Comment below!'
Apply to these tools
Browse all toolsFree AI Content Idea Generator
Keyword-driven content ideas for marketers
Detail AI Video Content Maker
Effortless AI-powered video creation
Rune Content
Advanced AI tool for creating comprehensive online courses
SEO Content AI
AI-powered content and SEO optimization tool
BBcomm Content Centre
Marketing technology that delivers for you
Compatible MCP servers
Browse all MCP serversFind the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan