bug_report_skill_registry

[ejhobenc]

Pre-flight Checklist

• I have searched existing issues and this is not a duplicate
• I understand that PRs will be rejected if the linked issue does not have status:approved

📝 Bug Description

Run gentle-ai skill-registry refresh --force

Expected Behavior

All three skills should appear in the generated ~/.atl/skill-registry.md.

Actual Behavior

Skill	Location	Frontmatter	Indexed?
pentest-recon	.config/opencode/skills/	✅ Yes	❌ No
pdd-governance	.config/opencode/skills/	❌ No	✅ Yes
branch-pr	.gemini/skills/	✅ Yes	✅ Yes

The scanner claims to scan .config/opencode/skills (visible in the "Sources scanned" section of the registry), but only indexes skills without YAML frontmatter from that directory.

Evidence

Skills in .config/opencode/skills/ with frontmatter — NOT indexed

pentest-code-review:  first_line='---', in_registry=0
pentest-recon:        first_line='---', in_registry=0
pentest-report:       first_line='---', in_registry=0
pentest-validate:     first_line='---', in_registry=0

Skills in .gemini/skills/ with frontmatter — indexed correctly

branch-pr:              first_line='---', in_registry=1
chained-pr:             first_line='---', in_registry=1
cognitive-doc-design:   first_line='---', in_registry=1
comment-writer:         first_line='---', in_registry=1
go-testing:             first_line='---', in_registry=1
issue-creation:         first_line='---', in_registry=1
judgment-day:           first_line='---', in_registry=1
skill-creator:          first_line='---', in_registry=1
work-unit-commits:      first_line='---', in_registry=1

Skill in .config/opencode/skills/ without frontmatter — indexed correctly

pdd-governance: first_line='# Skill: PDD Governance & Flow', in_registry=1

Registry output

## Sources scanned
- .gemini/skills
- .config/opencode/skills
- .gemini/antigravity/skills
- .codeium/windsurf/skills

Total indexed: 14 skills (9 from gemini + 1 from antigravity + 1 from opencode without frontmatter + 3 others)

Impact

• Pentest skills (recon, validate, code-review, report) are invisible to the skill registry
• Any workflow that depends on skill registry resolution for these skills will fail silently
• The issue is not immediately obvious because agent dispatch (via task with subagent_type) works independently of the registry

Workaround

None found. The --force flag does not change behavior. No debug/verbose flags available for the refresh command.

Suggested Fix

The YAML frontmatter parser for .config/opencode/skills/ should handle frontmatter the same way it does for .gemini/skills/. The inconsistency suggests the scanner uses different parsing logic for each source directory.

🔄 Steps to Reproduce

✅ Expected Behavior

All three skills should appear in the generated ~/.atl/skill-registry.md.

❌ Actual Behavior

Actual Behavior

Skill	Location	Frontmatter	Indexed?
pentest-recon	.config/opencode/skills/	✅ Yes	❌ No
pdd-governance	.config/opencode/skills/	❌ No	✅ Yes
branch-pr	.gemini/skills/	✅ Yes	✅ Yes

Gentle AI Version

1.43.2

Operating System

Linux (Ubuntu/Debian)

AI Agent / Client

OpenCode

📋 Affected Area

CLI (commands, flags)

💡 Logs / Error Output

Additional Context

No response

[Alan-TheGentleman]

This is clear and in scope. Adding status:approved. A PR linking this issue with Closes #1006 is welcome.