Skip to content

fix: point --no-skills projects upstream instead of at a missing .agents/ - #45

Merged
IBJunior merged 1 commit into
mainfrom
fix/agents-md-no-skills
Nov 8, 2026
Merged

IBJunior merged 1 commit into
mainfrom
fix/agents-md-no-skills

Conversation

@IBJunior

@IBJunior IBJunior commented Nov 8, 2026

Copy link
Copy Markdown
Member

Problem

A project scaffolded with --no-skills still got an AGENTS.md (and README) pointing at .agents/skills/tool-design/SKILL.md, which doesn't exist in that project.

Fix

  • project-generator.ts now copies the skill before rendering any template, and passes withSkills: skillCopied. That is whether the copy actually happened, not just the flag, so a failed copy is handled the same way.
  • Without the skill, AGENTS.md and both READMEs link to https://github.com/agentailor/skills/tree/main/tool-design and give:
    npx skills add agentailor/skills --skill tool-design
    This leaves out -a universal on purpose: whoever opted out picks the agent. The fallback hint printed after a failed copy keeps -a universal.
  • The README skill section moved to src/templates/common/skill-readme.ts, shared by the HTTP and stdio templates.
  • The repo AGENTS.md now documents the ordering rule.

Output with the skill installed (the default) is unchanged, apart from the README link now pointing at the skill's folder instead of the repo root.

Testing

  • New tests cover both branches for AGENTS.md (HTTP + stdio) and the README section, plus both transport READMEs.
  • npm run build, npm test (412 passing) and npm run lint pass.
  • Scaffolded --name=a (has .agents/, docs point at it) and --name=b --stdio --no-skills (no .agents/, docs show the link and command).

🤖 Generated with Claude Code

…nts/

The generated AGENTS.md and README always referenced
.agents/skills/tool-design/, even when the project was scaffolded with
--no-skills and that directory does not exist.

The skill is now copied before any template is rendered, and the docs
are rendered with withSkills set to whether the copy actually happened.
Without it, both link to the skill on GitHub and give
`npx skills add agentailor/skills --skill tool-design`. A failed copy
is covered by the same path.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@IBJunior
IBJunior merged commit 490e3b0 into main Nov 8, 2026
3 checks passed
@IBJunior
IBJunior deleted the fix/agents-md-no-skills branch November 8, 2026 20:26
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