Skip to content

Generate AGENTS.md from latest plugin skills - #288

Open
devin-ai-integration[bot] wants to merge 3 commits into
mainfrom
devin/vt-agents-from-skills
Open

Generate AGENTS.md from latest plugin skills#288
devin-ai-integration[bot] wants to merge 3 commits into
mainfrom
devin/vt-agents-from-skills

Conversation

@devin-ai-integration

@devin-ai-integration devin-ai-integration Bot commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Summary

vt create and vt clone were injecting the AGENTS.md bundled inside the std/vtEditorFiles template Val. That copy could drift from the latest platform guidance in val-town/plugins (e.g. older vals still recommended the global blob import).

This change keeps the local AGENTS.md current and short:

  • Adds @valtown/skills as a dependency.
  • In VTClient.addEditorTemplate, skips AGENTS.md from the editor template Val.
  • Synthesizes a concise AGENTS.md from skillList using generateAgentsMd:
    • Extracts ## Rules sections where they exist (blob-storage, sqlite-storage).
    • Falls back to the first paragraph of each skill.
    • Adds a ## Skill reference list, so agents with the Val Town plugin can load the full skill for a topic on demand.
  • Only writes the generated file if the project doesn't already have an AGENTS.md, preserving any val-specific instructions that came from the cloned Val.

Also includes the generated AGENTS.md in the repo as a preview and adds .github/workflows/agents-md.yml to regenerate and commit it on main whenever plugin skills change. scripts/generate-agents-md.ts produces the file using the same helper the CLI uses.

Link to Devin session: https://app.devin.ai/sessions/cf53d30505964e0686991b70129f4e62
Requested by: @stevekrouse

- Add @valtown/skills dependency
- Skip the editor template's AGENTS.md when adding editor files
- Synthesize an up-to-date AGENTS.md from skillList so / users always get current Val Town guidance
- Avoid overwriting an existing AGENTS.md from the cloned val

Co-Authored-By: Steve Krouse <steveykrouse@gmail.com>
@stevekrouse stevekrouse self-assigned this Aug 12, 2026
@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR that start with 'DevinAI' or '@devin'.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

devin-ai-integration Bot and others added 2 commits August 12, 2026 20:17
- Add generateAgentsMd helper to summarize skills into core conventions + skill reference

- Extract ## Rules sections when present, otherwise first paragraph

- Keeps AGENTS.md short and loadable in agent context

Co-Authored-By: Steve Krouse <steveykrouse@gmail.com>
- Add scripts/generate-agents-md.ts to synthesize AGENTS.md from plugin skills
- Commit generated AGENTS.md so the diff is visible in PRs
- Add .github/workflows/agents-md.yml to regenerate and commit AGENTS.md on main

Co-Authored-By: Steve Krouse <steveykrouse@gmail.com>
@tmcw

tmcw commented Aug 13, 2026

Copy link
Copy Markdown
Member

Needs a lockfile regenerated:

error: Unsupported lockfile version '5'. Try upgrading Deno or recreating the lockfile at '/home/runner/work/vt/vt/deno.lock'.

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.

2 participants