Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    Telegram WebApp 404 Auditor & Deployment Linter

    1

    Catches broken asset paths, repository mismatches, and missing cache-busters in your Python bot before deployment.

    $19.99

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    Telegram WebApp 404 Auditor & Deployment Linter

    Telegram WebApp 404 Auditor & Deployment Linter

    Example session with this skill installed

    Add a WebApp button to my Telegram bot that opens the frontend.
    WebAppInfo URL: https://user.github.io/bot-app/
    Repo name: wadv-demo

    • Read your context and instructions
    • Compiled the telegram webapp 404
    • Generated the UI component

    === INPUT ===
    WebAppInfo URL: https://user.github.io/bot-app/
    Repo name: wadv-demo
    index.html: at repo root

    === URL VALIDATION ===

    WebAppInfo URL: https://user.github.io/bot-app/
    Repo name: wadv-demo
    URL path: bot-app

    MISMATCH DETECTED
    WebAppInfo URL path 'bot-app' does not match repo name 'wadv-demo'.

    GitHub Pages serves from /<repo-name>/. The correct URL is:
    https://user.github.io/wadv-demo/

    If shipped as-is, the bot opens a 404 and the user sees a blank page.

    === CHECKLIST ===

    Step 1 — index.html location
    at root: True
    in subfolder: False
    Status: OK

    Step 2 — git status
    Clean — no untracked or unstaged files.

    Step 3 — push reached remote
    Run: git push origin main
    Then open in browser: https://user.github.io/wadv-demo/

    Step 4 — cache
    Telegram caches WebApp content. Hard reload: Ctrl+Shift+R on Desktop.
    On GitHub Pages: wait 1-2 minutes for the build.

    === FIXED VERSION ===

    WebAppInfo URL: https://user.github.io/wadv-demo/
    Repo name: wadv-demo
    URL path: wadv-demo

    MATCH. Checklist COMPLETE. Code emitted cleanly.

    index.html

    TSX · React component

    Generated

    Example file from a real run - the skill writes it into your workspace.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Stop wasting hours debugging blank screens and invisible 404 errors in your Telegram WebApps.

    You set up your Mini App, deployed the frontend to GitHub Pages, and tapped the button. But instead of your app, you get a completely dead white page. No errors in the bot logs, no warnings in the terminal. Just a broken user experience.

    The culprit is almost always a silent path mismatch. GitHub Pages serves files from /<repo-name>/, but AI agents routinely break asset paths, ignore bundler configs, or forget that Telegram aggressively caches mobile webviews.

    WebAppDeployValidator acts as an automated DevSecOps gatekeeper for your AI developer workspace.

    It hooks directly into your AI agent's code generation loop. Before a single line of code leaves the sandbox, the skill enforces a strict 6-rule static audit, cross-checking your dynamic URLs, bundler metadata (vite.config.js, next.config.js), and local Git states pre-runtime.

    🔍 Production-Ready Audits (Zero Network Overhead):

    • Instant 404 Prevention: Blasts URL and repository naming mismatches before you ever spin up the bot.
    • Zero Guesswork: Verification engine ensures index.html sits at the true deployment root and validates subpath rules for Vite, Next.js, Webpack, Parcel, and Angular.
    • Shutter Aggressive Caching: Automatically flags missing version hashes (?v=timestamp) so your mobile users never get trapped looking at old code.
    • Airtight Deployments: Returns a predictable, strictly typed JSON report tracking unpushed commits and incomplete deployment workflows.

    💡 Perfect for:

    • Killing silent blank-page bugs on newly generated WebApp layouts.
    • Auditing legacy code where bot URLs have fallen out of sync with updated infrastructure.
    • Bulletproofing GitHub Pages, Vercel, or Netlify pipelines against erratic AI refactoring.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Code Quality & Review.

    Tailored for static GitHub Pages deployments and standard Telegram WebApp environments. Operates entirely pre-runtime to audit repository structures and URL paths before deployment. The engine does not send live network requests or perform HTTP verification, making it fast, secure, and 100% air-gapped. Not intended for environments requiring complex server-side routing.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 21 days ago

    Software
    Python

    Permissions

    Read Files

    File Scopes

    **/*.py
    **/*.js
    **/*.ts
    **/index.html

    Built strictly for static analysis, reading your code to validate URL paths against the repository name. It operates under absolute sandbox constraints: zero terminal command executions, zero file mutations, and zero network access. The included check.py is an optional local validator designed to run independently, exclusively parsing JSON inputs.

    Listed1 month ago
    Updated1 month ago

    What's inside

    Frequently Asked Questions

    A: It hooks into your AI agent's generation loop to run an immediate static audit before code emission. The engine checks if your WebAppInfo path matches the repository architecture, catching the silent 404 deployment mistakes that produce dead blank pages on mobile devices.

    A: It is fully compatible with modern AI development tools including Claude Code, Cursor, and any workspace supporting custom system rules or instructions. It acts as a pre-runtime gatekeeper, flagging infrastructure bugs before the agent commits the code.

    A: No. The skill operates strictly as an air-gapped advisory tool and is completely non-destructive. It alerts your AI agent to output the exact git push commands and deployment steps, ensuring you remain in total control of your repository state.

    A: You get the complete static audit engine, pre-configured DevSecOps guardrail rules, and the structured JSON report schema. It forces the agent to process a strict 6-rule validation contract before generating any WebAppInfo blocks.

    A: Yes. While heavily optimized for GitHub Pages (where subfolder path mismatches are most common), the core static logic seamlessly audits any deployment workflow where asset routing, missing cache-busters, or unpushed git states can cause a 404.

    Yes. Telegram aggressively caches webview components on mobile devices. This skill strictly enforces code compliance by flagging any WebAppInfo URL that misses a query-string version parameter (CACHE_BUSTER_MISSING). It forces your AI agent to append cryptographic or timestamp parameters (?v=timestamp), breaking Telegram's cache execution pre-runtime and ensuring users always see the latest version instantly.

    New in Code Quality & Review