Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
|
I agree that displaying the rules/prompts is a bit much. I'd prefer that we have:
With that in mind, maybe we can turn these rules into copy prompts and/or doc examples (if the examples do not already exists in the docs). The copy prompts could be added to the most appropriate location in the docs. |
Transition documentation from ai-rules (.mdc) to agent-skills format. Updates navigation, internal links, and related pages.
3be3041 to
b714c45
Compare
| --- | ||
|
|
||
| <Admonition type="note" title="Agent Skills"> | ||
| Agent Skills are new and actively being improved. We'd love your feedback! Join us on [Discord](https://discord.gg/92vNTzKDGp) to share suggestions. |
There was a problem hiding this comment.
You could add that we have an agent experience channel for this!
| @@ -0,0 +1,32 @@ | |||
| --- | |||
There was a problem hiding this comment.
If I understand this correctly, these ai/agent-skills-* files would be indexes for a given topic from which the agent can then go deeper by following the references listed here?
There was a problem hiding this comment.
Yes, although this is a good question. Honestly, it's repurposing the existing rules pages (rename->update) so is limited in nature (only 6) for this initial conversion.
Upon reimagining, let's discuss soon about how agent skills can integrate more closely (and become) the documentation.
|
|
||
| The AI assistant automatically uses the installed Neon skill to provide accurate, up-to-date guidance for authentication setup, including proper imports, configuration, and best practices. | ||
|
|
||
| ### Alternative: Browse individual references |
There was a problem hiding this comment.
I would cut this section - not sure why this would be needed :)
|
|
||
| Once installed, your AI assistant can access {name} guidance automatically without manual configuration. | ||
|
|
||
| ### Alternatives |
There was a problem hiding this comment.
Same here - I don't think I understand the workflow one would use when following this section?
Transition documentation from ai-rules (.mdc) to agent-skills format. Updates navigation, internal links, and related pages.
Note: This PR is not ready to merge but is okay to review. Thinking of alternatives to our ExternalCode usage here as it can be overwhelming. One idea is to have copy/view skill options rather than insert the entire skill into the doc.
Post-MVP enhancements include integrating skills with our custom prompts, include skill references in llms.txt, and investigate adding an llms-full.txt.