exists - SKILL.md Agent Skill

name: exists description: "Check whether a documentation topic is already covered on strapi/documentation: searches llms.txt, doc files, sidebars, and open GitHub PRs." argument-hint: "[--no-log] " user-invocable: true

/inki:exists: find existing coverage on a topic

Input

$ARGUMENTS: a topic or keyword (e.g. MCP server, hasPublishedVersion, openapi.json route).

If no argument is provided and the conversation has context (e.g. a PR was just discussed), extract the relevant keywords from context.

Logging: unless --no-log is passed, write this skill's report to the run log per ../../references/logging.md (--log-dir <path> and --short-log are also accepted). When invoked as part of an orchestrator (e.g. /inki:research), write into that run's existing directory instead of creating a new one.

Step 1: Search the page index

Read docusaurus/static/llms.txt at the repo root and find lines mentioning the topic (case-insensitive).

REPO_ROOT=$(git rev-parse --show-toplevel)
grep -i "<topic>" "$REPO_ROOT/docusaurus/static/llms.txt" | head -20

Step 2: Search doc files

REPO_ROOT=$(git rev-parse --show-toplevel)
grep -rli "<topic>" "$REPO_ROOT/docusaurus/docs/cms" "$REPO_ROOT/docusaurus/docs/cloud" 2>/dev/null | head -20

For each match, optionally check when it was last touched:

git log -1 --format="%ai" -- "<path>"

Step 3: Search sidebars

REPO_ROOT=$(git rev-parse --show-toplevel)
grep -in "<topic>" "$REPO_ROOT/docusaurus/sidebars.js" | head -20

Step 4: Search GitHub PRs

gh pr list --repo strapi/documentation --state all --search "<topic>" --limit 20 --json number,title,state,url

Bucket the PRs as: open (might be in progress), merged (might already cover the topic), closed-not-merged (abandoned attempts).

Step 5: Synthesize

Report in this format:

Coverage check: "<query>"

Pages on docs.strapi.io that mention it:
- <path 1> (last updated YYYY-MM-DD, coverage: full | partial | mention)
- <path 2>

Sidebars referencing it:
- <entry>

PRs:
- Open:    #<num> "<title>": <url>
- Merged:  #<num> "<title>": <url>
- Closed:  #<num> "<title>": <url>

Verdict: COVERED | PARTIAL | IN PROGRESS | NOT DOCUMENTED

Suggested next step: <e.g. "Run /inki:route with the related strapi/strapi PR" | "Run /inki:outline to start a new page" | none>

Rules

Never modify files.
If none of the 4 sources match, report NOT DOCUMENTED clearly and suggest the next step.
When several pages match, surface at most 5, ordered by relevance.