Justify internal links

Support internal-link suggestions with source, target, anchor, and placement evidence.

EXECUTED / V0.1.0 / PARTIAL

Goal

Create ten internal-link suggestions that connect a real source passage to a useful target page and can be reviewed by a person.

In scope

  • provided crawl or link export
  • source and target URL
  • specific source passage
  • anchor suggestion
  • user and crawl path

Out of scope

  • automatic link insertion
  • exact-match anchor quotas
  • portfolio-wide link patterns
  • link suggestions without reading page content

Allowed sources

  • Crawl and link export
  • HTML or Markdown page copies
  • Repository (read-only)

Acceptance criteria

  1. Every suggestion names source and target.
  2. The source passage supports the link.
  3. Anchor and placement are natural and not coordinated.
  4. Existing links and canonical targets were considered.
  5. No link was inserted automatically.

Failure signals

  1. Suggestions based only on URL slugs
  2. Sitewide exact-match anchors
  3. Links to non-canonical or unhelpful targets
  4. A claimed passage without read content
STOP RULE

Stop and ask if page content cannot be read, the target is not canonical, or write access would be required.

A dated first-party run exists for this specification. Review its result state and limits before turning it into a skill.