Skip to content

feat: point AI agents at the skill from --help and init - #268

Draft
angeloashmore wants to merge 5 commits into
mainfrom
aa/ai-agent-hints--hive-9
Draft

feat: point AI agents at the skill from --help and init#268
angeloashmore wants to merge 5 commits into
mainfrom
aa/ai-agent-hints--hive-9

Conversation

@angeloashmore

@angeloashmore angeloashmore commented Aug 28, 2026

Copy link
Copy Markdown
Member

Resolves: N/A

Description

An agent that runs npx prismic --help or prismic init gets no pointer to the Prismic skill. It falls back to training data instead.

Add a hint to two places:

  • The root --help description.
  • prismic init success output, both the starter-handoff branch and the plain-init branch.

The hint points only to the skill: "Using an AI agent? Teach it how to use Prismic by installing the Prismic skill: npx skills add --global --yes prismicio/skills". --yes skips the confirmation prompts, so an agent can run the command without hanging.

The line lives in one place, AI_AGENT_HINT in src/lib/ai.ts.

No skill detection is added. The hint always shows, for simplicity.

Checklist

  • If my changes require tests, I added them.
  • If my changes affect backward compatibility, it has been discussed.
  • If my changes require an update to the CONTRIBUTING.md guide, I updated it.

Preview

N/A

How to QA

Run npx prismic --help and check the description includes the AI-agent hint. Run prismic init against a repo and check the success output includes the same hint.

An agent that runs the CLI without the skill gets no pointer to it. Add a hint to the root --help text and to prismic init's success output. The hint names the skill install command first and the docs command second.
@angeloashmore

Copy link
Copy Markdown
Member Author

Please shorten the hint. Drop the docs list pointer and point only to the skill. The skill tells the agent what to do, including where the docs are. Use this one line in both the root --help description and the init output:

Using an AI agent? Teach it how to use Prismic by installing the Prismic skill: npx skills add --global prismicio/skills

@angeloashmore

Copy link
Copy Markdown
Member Author

Done in 20eae12. Both the root --help description and init output now use the shortened line, no docs list pointer.

@angeloashmore

Copy link
Copy Markdown
Member Author

One small change: add --yes to the install command, so it reads npx skills add --global --yes prismicio/skills. It skips the confirmation prompts so an agent can run the command without hanging. It still installs to every detected agent. This matches the Prismic CLI docs.

@angeloashmore

Copy link
Copy Markdown
Member Author

Done in ddd8391. Both spots use npx skills add --global --yes prismicio/skills through the shared AI_AGENT_HINT constant.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant