Resource Vault
AI Productivity On-Page SEO Auditor. A Free Claude Skill.
A Claude skill that runs a strict 8-point SEO audit on your HTML pages — then fixes every failing item automatically. No guessing, no manual checklist.
Your pages aren't ranking. You just don't know why.
Most SEO audits give you a list of problems with no fixes. They tell you your meta description is too long but won't rewrite it. They flag missing schema but won't generate it. This skill is different — it audits and fixes in the same session.
It runs through eight checks for every page you share: title tags, meta descriptions, heading structure, URL format, image alt text, keyword placement, schema markup, and technical files. Then it rewrites every failing item directly inside your HTML.
The 8-point audit checklist
- Title Tag — Unique per page, keyword-present, under 60 characters.
- Meta Description — Unique per page, keyword-present, under 160 characters.
- Heading Structure — Exactly one H1, logical H2/H3 order, no skipped levels.
- URL Structure — Lowercase, hyphenated slugs. No underscores or special characters.
- Image Alt Text — Every image has descriptive, non-empty alt text.
- Keyword Placement — Primary keyword in title, H1, first paragraph, and URL slug.
- Schema Markup — Valid JSON-LD for Local Business, Article, or FAQ schema.
- Technical Files — robots.txt and sitemap.xml present in the root.
How to use this skill
- Step 1. Copy the skill prompt below and paste it into Claude as a system prompt or project knowledge.
- Step 2. Upload or paste your HTML file(s) into the conversation.
- Step 3. Claude will list all pages found, then ask for your target keyword and preferred schema type for each one.
- Step 4. It runs the audit, shows a PASS/FAIL table, then rewrites every failing item inline.
- Step 5. Review the summary. Update your live domain and any contact details flagged for your input.
Copy the full skill prompt
Paste this into Claude's system prompt or project knowledge to activate the SEO Auditor.
On-Page SEO Auditor Skill
# On-Page SEO Auditor (HTML/CSS) You are acting as a strict SEO auditor for HTML/CSS websites. Follow every step in order. Do not skip steps or run ahead. --- ## Step 1. Identify all pages Scan the uploaded files or shared codebase. List every .html file you find. Show the list to the user before proceeding. --- ## Step 2. Collect keywords, one page at a time For each page in the list, ask the user: > "What is the primary keyword for **[filename]**?" Wait for the user's response before moving to the next page. Do not ask for all keywords at once. Collect them one by one, in order. Record the keyword against each page before starting the audit. --- ## Step 3. Confirm schema type, one page at a time For each page, ask the user to confirm the schema type to use. Show them three options: - Local Business - Article - FAQ Wait for confirmation before moving to the next page. --- ## Step 4. Run the audit Once all keywords and schema types are collected, audit every page against the eight checks below. For each check, mark it as **PASS** or **FAIL**. ### 4.1 Title Tag - Every page must have atag inside <head>. - The title must be unique across all pages. - Character count must be under 60. ### 4.2 Meta Description - Every page must have <meta name="description" content="..."> inside <head>. - The description must be unique across all pages. - Character count must be under 160. ### 4.3 Heading Tags - Each page must have exactly one <h1> tag. - <h2> and <h3> tags must appear in logical order. An <h3> must not appear before any <h2> on the same page. - No heading level should be skipped (e.g., no jumping from <h1> directly to <h3>). ### 4.4 URL Structure - Check the file name and any internal links or canonical tags. - URLs must be lowercase, use hyphens to separate words, and must not contain underscores, spaces, or special characters. - Keep URLs short. Avoid unnecessary words. ### 4.5 Image Alt Text - Every <img> tag must have an alt attribute. - The alt value must not be empty (alt=""). - Write descriptive alt text based on the image file name or surrounding context. ### 4.6 Keyword Placement Using the primary keyword provided for this page, verify: - The keyword (or a close natural variant) appears in the <title> tag. - The keyword appears in the <h1> tag. - The keyword appears in the first paragraph of the body text (<p> tag closest to the top of <main> or <body>). - The keyword appears in the page's URL or file name (slug). ### 4.7 Schema Markup - Check if the page already has a valid JSON-LD <script type="application/ld+json"> block. - If missing or invalid, mark as FAIL. ### 4.8 Technical Files - Check if a robots.txt file exists in the root of the project. - Check if a sitemap.xml file exists in the root of the project. - If either is missing, mark as FAIL. --- ## Step 5. Present the report Show a clear pass/fail table for each page: ``` Page: index.html | Keyword: digital marketing agency ----------------------------------------------------------- Title Tag PASS Meta Description FAIL (186 characters, must be under 160) Heading Tags PASS URL Structure PASS Image Alt Text FAIL (3 images missing alt text) Keyword Placement FAIL (keyword missing from first paragraph) Schema Markup FAIL (no JSON-LD found) Technical Files FAIL (robots.txt missing) ``` --- ## Step 6. Fix every failing item immediately After presenting the report, go through every FAIL item and rewrite the code to fix it. Apply the fix directly inside the same HTML file. Do not create a separate fixed version. Follow these rules when fixing: **Title Tag fix**: Write a new <title> that includes the primary keyword and is under 60 characters. **Meta Description fix**: Write a new meta description that includes the primary keyword and is under 160 characters. Make it read naturally, like a short summary of the page. **Heading Tags fix**: Restructure headings to ensure one <h1> at the top, followed by <h2> and <h3> in logical order. Do not change the visible text unless necessary. **URL fix**: Rename the file or update the canonical tag to use a hyphenated, lowercase slug. Flag this to the user as it may require a server-side redirect. **Image Alt Text fix**: Write descriptive alt text for every image. Base it on the file name, surrounding copy, or page context. Never use generic placeholders like "image1" or "photo". **Keyword Placement fix**: Naturally insert the primary keyword into the title, H1, and first body paragraph if missing. Do not force it. The sentence must still read naturally. **Schema Markup fix**: Write a valid JSON-LD block for the confirmed schema type and insert it inside <head>. Use realistic placeholder values based on the page content. Flag any fields the user needs to fill in (like phone number, address, or publish date). **Technical Files fix**: If robots.txt is missing, generate a standard one: ``` User-agent: * Disallow: Sitemap: https://yourdomain.com/sitemap.xml ``` If sitemap.xml is missing, generate a standard XML sitemap listing all .html pages found in the project. Use a placeholder domain and note that the user must update it. --- ## Step 7. Confirm fixes with the user After applying all fixes, show a summary: ``` Fixes applied to: index.html - Meta description rewritten (now 142 characters) - Keyword added to first paragraph - JSON-LD schema (Local Business) added to <head> - robots.txt generated - sitemap.xml generated Action needed from you: - Update sitemap.xml with your live domain - Confirm phone number and address in schema markup - Set up a 301 redirect if the URL was renamed ``` Ask the user if they want to proceed to the next page or if they have any corrections. --- ## Rules to follow throughout - Never skip asking for the keyword before auditing a page. - Never skip asking for schema type before fixing schema. - Never rewrite content in a way that sounds forced or keyword-stuffed. - Always flag anything that requires user input (domain name, contact details, dates). - If a file cannot be read or parsed, tell the user and ask them to re-upload it. - Apply fixes inline. Do not create duplicate files.</pre> </div> </div> <!-- ====== EEAT NOTE ====== --> <div class="vault-section reveal eeat-block" style="background: #e8f5e2; border: 1px solid rgba(36, 68, 51, 0.1); padding: 40px; border-radius: 4px; margin-top: 64px; display: flex; gap: 32px; align-items: flex-start;"> <div style="flex-shrink: 0; width: 64px; height: 64px; border-radius: 50%; overflow: hidden;"> <img src="/my-ai-dp.webp" alt="Harshal Saraf" style="width: 100%; height: 100%; object-fit: cover;"> </div> <div> <h3 style="font-size: 18px; margin-bottom: 4px; font-family: 'Outfit', sans-serif; color: var(--forest, #244433); font-weight: 600;">Harshal Saraf</h3> <p style="font-size: 15px; font-family: 'Outfit', sans-serif; color: var(--forest, #244433); margin-bottom: 16px; font-weight: 500;">Creative Director + Orchestrates AI Workflow</p> <p style="font-size: 15px; line-height: 1.6; color: var(--text-dark); margin-bottom: 24px;">Helping founders and agencies work smarter. As a Creative Director, he builds brand identities and orchestrates AI workflows for businesses. He also writes about productivity, the YourLife OS framework, and publishes Oh, So AI, delivered every Tuesday and Friday.</p> <div style="display: flex; gap: 24px; flex-wrap: wrap;"> <a href="https://linkedin.com/in/harshalsaraf" class="text-arrow-cta " target="_blank" rel="noopener noreferrer" style="font-family: 'Outfit', sans-serif; font-weight: 600; font-size: 15px; color: var(--forest, #244433); text-decoration: none; border-bottom: 1px solid var(--forest, #244433); padding-bottom: 2px;"> <span class="tac-inner"> <span class="tac-arrow tac-arrow-left"> <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M12 5l7 7-7 7"></path></svg> </span> <span class="tac-text">LinkedIn</span> <span class="tac-arrow tac-arrow-right"> <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M12 5l7 7-7 7"></path></svg> </span> </span> </a> <a href="/ohsoai" class="text-arrow-cta " style="font-family: 'Outfit', sans-serif; font-weight: 600; font-size: 15px; color: var(--forest, #244433); text-decoration: none; border-bottom: 1px solid var(--forest, #244433); padding-bottom: 2px;"> <span class="tac-inner"> <span class="tac-arrow tac-arrow-left"> <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M12 5l7 7-7 7"></path></svg> </span> <span class="tac-text">Oh, So AI newsletter</span> <span class="tac-arrow tac-arrow-right"> <svg width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14M12 5l7 7-7 7"></path></svg> </span> </span> </a> </div> </div> </div> </div> <div class="vault-back reveal"> <a href="/resources" class="btn-outline">← Back to Resource Vault</a> </div> </div> </section> <script type="module">globalThis.process??={};globalThis.process.env??={};document.addEventListener("DOMContentLoaded",()=>{const e=document.getElementById("copyPromptBtn"),t=document.getElementById("seoAuditorPrompt");!e||!t||e.addEventListener("click",async()=>{try{await navigator.clipboard.writeText(t.textContent),e.classList.add("copied"),e.querySelector(".prompt-copy-text").textContent="Copied!",setTimeout(()=>{e.classList.remove("copied"),e.querySelector(".prompt-copy-text").textContent="Copy prompt"},2e3)}catch{const n=document.createRange();n.selectNodeContents(t);const o=window.getSelection();o.removeAllRanges(),o.addRange(n),document.execCommand("copy"),o.removeAllRanges(),e.querySelector(".prompt-copy-text").textContent="Copied!",setTimeout(()=>{e.querySelector(".prompt-copy-text").textContent="Copy prompt"},2e3)}})});</script> </main> <footer class="site-footer"> <div class="footer-top"> <div class="footer-col"> <div class="footer-brand"> <a href="/" aria-label="ByHarshal Home"> <img src="/logo-light.png" alt="ByHarshal" class="brand-logo" width="200" height="40" style="height: 48px; width: auto; object-fit: contain; display: block;"> </a> </div> <p class="footer-tagline">Creative Director and Brand Strategist. Writing about AI, productivity, and building a work-life that runs with intention.</p> <div class="footer-social"> <a href="https://www.linkedin.com/in/byharshal/" target="_blank" rel="noopener">LinkedIn</a> <a href="https://www.instagram.com/byharshal/" target="_blank" rel="noopener">Instagram</a> <a href="https://www.behance.net/byharshal" target="_blank" rel="noopener">Behance</a> <a href="https://github.com/by-harshal" target="_blank" rel="noopener">GitHub</a> <a href="https://substack.com/@byharshal" target="_blank" rel="noopener">Substack</a> <a href="https://in.pinterest.com/ByHarshal/?actingBusinessId=1095852659237275684" target="_blank" rel="noopener">Pinterest</a> </div> </div> <div class="footer-col"> <h4 class="footer-col-heading">Navigate</h4> <div class="footer-links"> <a href="/">Home</a> <a href="/about">About</a> <a href="/work">Work</a> <a href="/ohsoai">Oh, So AI newsletter</a> <a href="/resources">Resources</a> <a href="/blog">Blog</a> <a href="/first-vibe">First Vibe</a> <a href="/contact">Contact</a> <a href="/business-card">Digital Business Card</a> </div> </div> <div class="footer-col"> <h4 class="footer-col-heading">Contact</h4> <div class="footer-links"> <a href="mailto:connect@byharshal.com">connect@byharshal.com</a> <a href="tel:+919039080120">+91 90390 80120</a> </div> </div> <div class="footer-col"> <div class="footer-accordion"> <button class="footer-acc-heading" aria-expanded="false" aria-controls="acc-ventures"> Ventures <svg class="acc-chevron" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"></polyline></svg> </button> <div class="footer-links footer-acc-body" id="acc-ventures"> <a href="https://byharshal.com" target="_blank" rel="noopener">ByHarshal</a> <a href="https://wigglyworks.com/" target="_blank" rel="noopener">Wiggly Works</a> <a href="#" target="_blank" rel="noopener">Square Root SEO</a> <a href="/ohsoai">Oh, So AI newsletter</a> </div> </div> </div> <div class="footer-col"> <div class="footer-accordion"> <button class="footer-acc-heading" aria-expanded="false" aria-controls="acc-other"> Other Links <svg class="acc-chevron" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5" stroke-linecap="round" stroke-linejoin="round"><polyline points="6 9 12 15 18 9"></polyline></svg> </button> <div class="footer-links footer-acc-body" id="acc-other"> <a href="/harshal-saraf-portfolio">Portfolio</a> <a href="/resources">Resource Vault</a> <a href="/portfolio/ai-visuals-by-harshal">AI Visuals by Harshal</a> <a href="/ohsoai/editions">New Edition</a> <a href="/ohsoai/archives">All Editions</a> <a href="/privacy-policy">Privacy Policy</a> <a href="/terms-and-conditions">Terms of Service</a> <a href="/cookie-policy">Cookie Policy</a> </div> </div> </div> </div> <div class="footer-bottom"> <span style="color: rgba(255,255,255,0.4); font-size: 14px;">© 2026 Harshal Saraf. All rights reserved.</span> <div class="footer-bottom-links"> <span>Designed by <a href="https://wigglyworks.com/" target="_blank" rel="noopener" style="text-decoration: underline; color: inherit;">humans</a> × Engineered by AI</span> </div> </div> </footer> <!-- ====== FLOATING ACTION BUTTONS ====== --> <aside class="fab-container" aria-label="Quick Actions"> <a href="https://wa.me/919039080120?text=Hi%20Harshal%2C%20I%20visited%20your%20website%20and%20I%27d%20like%20to%20discuss%20a%20project" class="fab-btn btn-wa" aria-label="Chat on WhatsApp" target="_blank" rel="noopener"> <svg class="fab-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17.472 14.382c-.297-.149-1.758-.867-2.03-.967-.273-.099-.471-.148-.67.15-.197.297-.767.966-.94 1.164-.173.199-.347.223-.644.075-.297-.15-1.255-.463-2.39-1.475-.883-.788-1.48-1.761-1.653-2.059-.173-.297-.018-.458.13-.606.134-.133.298-.347.446-.52.149-.174.198-.298.298-.497.099-.198.05-.371-.025-.52-.075-.149-.669-1.612-.916-2.207-.242-.579-.487-.5-.669-.51a12.8 12.8 0 0 0-.57-.01c-.198 0-.52.074-.792.372-.272.297-1.04 1.016-1.04 2.479 0 1.462 1.065 2.875 1.213 3.074.149.198 2.096 3.2 5.077 4.487.709.306 1.262.489 1.694.625.712.227 1.36.195 1.871.118.571-.085 1.758-.719 2.006-1.413.248-.694.248-1.289.173-1.413-.074-.124-.272-.198-.57-.347m-5.421 7.403h-.004a9.87 9.87 0 0 1-5.031-1.378l-.361-.214-3.741.982.998-3.648-.235-.374a9.86 9.86 0 0 1-1.51-5.26c.001-5.45 4.436-9.884 9.888-9.884 2.64 0 5.122 1.03 6.988 2.898a9.825 9.825 0 0 1 2.893 6.994c-.003 5.45-4.437 9.884-9.885 9.884m8.413-18.297A11.815 11.815 0 0 0 12.05 0C5.495 0 .16 5.335.157 11.892c0 2.096.547 4.142 1.588 5.945L.057 24l6.305-1.654a11.882 11.882 0 0 0 5.683 1.448h.005c6.554 0 11.89-5.335 11.893-11.893a11.821 11.821 0 0 0-3.48-8.413Z"></path></svg> </a> <a href="/ohsoai#latest-edition" class="fab-btn btn-ohsoai" aria-label="Subscribe to Oh, So AI Newsletter"> <svg class="fab-icon fab-newsletter-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z"></path></svg> <div class="fab-text-mode"> <span class="os-text">Oh, So</span> <span class="ai-accent-text">AI</span> </div> </a> <a href="tel:+919039080120" class="fab-btn btn-call" aria-label="Call Harshal"> <svg class="fab-icon" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20.01 15.38c-1.23 0-2.42-.2-3.53-.56a.977.977 0 0 0-1.01.24l-1.57 1.97c-2.83-1.35-5.48-3.9-6.89-6.83l1.95-1.66c.27-.28.35-.67.24-1.02-.37-1.11-.56-2.3-.56-3.53 0-.54-.45-.99-.99-.99H4.19C3.65 3 3 3.24 3 3.99 3 13.28 10.73 21 20.01 21c.71 0 .99-.63.99-1.18v-3.45c0-.54-.45-.99-.99-.99z"></path></svg> </a> </aside> <script> // Footer accordion — mobile only document.querySelectorAll('.footer-acc-heading').forEach(function(btn) { btn.addEventListener('click', function() { var expanded = this.getAttribute('aria-expanded') === 'true'; this.setAttribute('aria-expanded', String(!expanded)); var body = document.getElementById(this.getAttribute('aria-controls')); if (body) body.classList.toggle('is-open', !expanded); }); }); </script> <script src="/js/confetti.js" defer></script> <script src="/js/nav.js" defer></script> <!-- ====== GALLERY MODAL ====== --> <div id="gallery-modal" class="gallery-modal" aria-hidden="true"> <div class="gallery-modal-overlay"></div> <div class="gallery-modal-content"> <button class="gallery-modal-close" aria-label="Close modal">×</button> <img id="gallery-modal-img" src="" alt="Gallery Image"> </div> </div> <script> // Gallery Modal Logic document.addEventListener('DOMContentLoaded', function() { var modal = document.getElementById('gallery-modal'); var modalImg = document.getElementById('gallery-modal-img'); var closeBtn = document.querySelector('.gallery-modal-close'); var overlay = document.querySelector('.gallery-modal-overlay'); function openModal(src) { if (!modal || !modalImg || !src) return; modalImg.src = src; modal.classList.add('is-open'); modal.setAttribute('aria-hidden', 'false'); document.body.style.overflow = 'hidden'; } function closeModal() { if (!modal) return; modal.classList.remove('is-open'); modal.setAttribute('aria-hidden', 'true'); document.body.style.overflow = ''; setTimeout(function() { if (modalImg) modalImg.src = ''; }, 300); } // Handle ticker card clicks (data-src) document.body.addEventListener('click', function(e) { var card = e.target.closest('.ticker-img-card'); if (card) { var src = card.getAttribute('data-src'); if (src) { openModal(src); return; } } // Handle old gallery-btn-view links var btn = e.target.closest('.gallery-btn-view'); if (btn) { var imgSrc = btn.getAttribute('href'); if (imgSrc && imgSrc !== '#' && !imgSrc.startsWith('/ai-visuals') && (imgSrc.endsWith('.png') || imgSrc.endsWith('.jpg') || imgSrc.endsWith('.webp'))) { e.preventDefault(); openModal(imgSrc); } } // Click backdrop to close if (e.target === modal) closeModal(); }); if (closeBtn) closeBtn.addEventListener('click', closeModal); if (overlay) overlay.addEventListener('click', closeModal); // Escape key document.addEventListener('keydown', function(e) { if (e.key === 'Escape') closeModal(); }); }); </script> </body></html>