Skip to content

fix(import): skip loose .md docs; ship 3 agents + 2 commands to the bundle - #13

Merged
deve1993 merged 2 commits into
mainfrom
fix/importer-skip-loose-md
Sep 14, 2026
Merged

deve1993 merged 2 commits into
mainfrom
fix/importer-skip-loose-md

Conversation

@deve1993

Copy link
Copy Markdown
Collaborator

Summary

Two pieces of local-only work that never reached the repo.

1. Importer: loose .md docs are no longer imported as skills

.agents/skills/ holds AGENTS.md, CLAUDE.md, SKILLS-MAP.md and pending-review.md next to the skill directories. walkDir imported every loose .md in a skill zone as a skill named after the file, so documentation leaked into local catalogs.

A loose .md now counts as a skill only when it declares frontmatter. Unchanged:

  • directory skills (<name>/SKILL.md, <name>/AGENT.md)
  • commands and flat agents, which have their own loaders

Prod is unaffected: its container links only SKILL.md files into .agents/skills/.

2. Bundle: 3 agents + 2 commands

These existed only in the local workspace mirror, so the production catalog never had them:

  • agent:orchestrator
  • agent:skill-syncer (proposes skill updates from skill:* memories into _pending/)
  • agent:video-producer
  • command:project (wraps the project_* MCP tools)
  • command:skill-sync

Hardcoded /Users/dan/... paths are replaced with repo-relative ones. They reach prod on the next deploy through the hash-gated boot import. All five passed the skill-guard security gate in a local import.

Test plan

  • New test imports a loose .md from a skill zone only when it declares frontmatter failed first: SKILLS-MAP was imported. It passes after the fix.
  • pnpm --filter @skillbrain/storage test: 40/40
  • packages/codegraph tests: 308/308
  • After deploy: agent_read({ name: "skill-syncer" }) and skill_read({ name: "command:project" }) resolve in prod

Note for reviewers

orchestrator/AGENT.md has no frontmatter and still names claude-opus-4-6 and OpenCode-era load_skills / session_id. It overlaps with @Planner and with the new "orchestration runs in the main session" rule in AGENTS.md. It is shipped as-is; refreshing or retiring it is a follow-up.

🤖 Generated with Claude Code

OpenCode Bot and others added 2 commits September 14, 2026 20:09
.agents/skills/ carries AGENTS.md, CLAUDE.md, SKILLS-MAP.md and
pending-review.md next to the skill directories. walkDir imported every
loose .md as a skill named after the file, so local catalogs gained
documentation rows. A loose .md now counts as a skill only when it declares
frontmatter; directory skills (SKILL.md / AGENT.md) are unaffected, and
commands and flat agents use their own loaders.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…ts plus /project and /skill-sync commands

These existed only in the local workspace, so the production catalog never
received them. Hardcoded /Users/dan/... paths replaced with repo-relative
ones so they work for every teammate and in the container.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@deve1993
deve1993 merged commit 49d6175 into main Sep 14, 2026
1 check passed
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