internal-links

Validate CTA hrefs and Next.js Link wrappers on site pages.

Updated Nov 18, 2025
One-click install
npx skills add https://github.com/deomiarn/website-template --skill internal-links
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: internal-links
Source: https://github.com/deomiarn/website-template/tree/main/.claude/skills/internal-links
Command: npx skills add https://github.com/deomiarn/website-template --skill internal-links

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ensures every button and link points to a valid internal page or in-page anchor, improving navigation reliability and SEO.

Core Features & Use Cases

  • CTA Validation: Verify all CTAs have proper hrefs.
  • Link Patterns: Enforce Next.js Link usage for internal routing.
  • Anchor Targets: Add IDs to sections used as in-page anchors.

Quick Start

Audit a page, then wrap missing buttons with Link and add matching IDs to target sections.

Frequently Asked Questions about internal-links

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix broken internal links in Next.js pages?

Broken internal links occur when CTAs lack valid hrefs or point to non-existent pages. Audit your Next.js pages to verify all Button, Link, and anchor elements have proper hrefs, wrap internal links with Next.js Link components, and ensure target sections have matching IDs for in-page anchors.

What's the best way to ensure all CTAs point to valid destinations?

Validate every CTA by checking that hrefs reference existing internal pages or section IDs. Enforce Next.js Link wrappers for internal routing, use Button asChild when needed, and add missing section IDs to anchor targets across hero, features, pricing, and FAQ sections.

Do I need to wrap buttons with Next.js Link for internal routing?

Yes, Next.js Link wrappers are required for internal routing to maintain proper navigation performance. When using Button components, apply asChild to allow Link to wrap them while preserving button styling and behavior.

How do I set up anchor links to specific sections on a page?

Anchor links require two steps: add matching section IDs to your target elements and ensure CTAs reference those IDs in href attributes. This enables users to jump to specific content and improves SEO for in-page navigation.

Can I validate internal links across multiple Next.js components at once?

Yes, systematic validation audits entire pages and components—hero, features, pricing, projects, FAQ—checking all Button, Link, and anchor elements for valid hrefs, proper Next.js Link wrapping, and corresponding section IDs in a single pass.

What happens when i18n CTA text is missing in internal links?

Missing i18n CTA text disrupts multilingual navigation consistency. The validation process updates i18n CTA text alongside href verification to ensure links display correctly across localized versions of your site.