Sync AGENTS.md skill index with actual skill files

t-426·WorkTask·
·
·
Created1 month ago·Updated1 month ago

Description

Edit

Sync AGENTS.md skill index with actual skill files in the repo.

Context

AGENTS.md has tables listing available skills, but they're out of sync with what actually exists:

Missing from AGENTS.md:

  • Omni/Agent/Skills/*.md — Tool-specific skills (browser, calendar, http, pdf, etc.)
  • Biz/Skills/ReadHackerNews.md
  • Omni/Agent/Roles/Reviewer.md

In AGENTS.md but need verification:

  • All listed skills should be checked to ensure they still exist and are accurate

Current State

AGENTS.md has skill tables organized by category:

  • Development
  • Research
  • Agent
  • Products
  • Customer Development

But Omni/Agent/Skills/ contains 10 tool-specific skills not listed anywhere:

  • browser.md
  • calendar.md
  • code-search.md
  • email.md
  • http.md
  • pdf.md
  • transcribe.md
  • vision.md
  • web-reader.md
  • web-search.md

Goal

Update AGENTS.md to include all skills, organized logically.

Approach

1. Run skill-browser list to see all skills 2. Compare with AGENTS.md tables 3. Add missing skills to appropriate categories 4. Consider adding a new "Tools" category for Omni/Agent/Skills/*.md 5. Verify all listed paths still exist 6. Update descriptions to match actual skill content

Suggested New Category

Add a "Tools" section for the tool-specific skills:

### Tools

| Skill | Path | When to use |
|-------|------|-------------|
| Browser | `Omni/Agent/Skills/browser.md` | Headless browser automation |
| Calendar | `Omni/Agent/Skills/calendar.md` | Access calendar data |
| Code Search | `Omni/Agent/Skills/code-search.md` | Find code with rg/grep |
| Email | `Omni/Agent/Skills/email.md` | Send emails via CLI |
| HTTP | `Omni/Agent/Skills/http.md` | Make HTTP requests with curl |
| PDF | `Omni/Agent/Skills/pdf.md` | Extract text from PDFs |
| Transcribe | `Omni/Agent/Skills/transcribe.md` | Transcribe audio |
| Vision | `Omni/Agent/Skills/vision.md` | Image analysis |
| Web Reader | `Omni/Agent/Skills/web-reader.md` | Extract text from web pages |
| Web Search | `Omni/Agent/Skills/web-search.md` | Search with Kagi API |

Verification

After changes: 1. Every skill in skill-browser list should be in AGENTS.md 2. Every path in AGENTS.md should exist as a file 3. Descriptions should match skill content

# Check all paths exist
grep -oE '\`[^`]+\.md\`' AGENTS.md | tr -d '`' | while read f; do
  [ -f "$f" ] || echo "MISSING: $f"
done

Files to Modify

  • AGENTS.md — Update skill tables

Acceptance Criteria

  • [ ] All Omni/Agent/Skills/*.md files listed in AGENTS.md
  • [ ] Biz/Skills/ReadHackerNews.md added
  • [ ] All listed paths verified to exist
  • [ ] Descriptions accurate and helpful
  • [ ] Skills organized into logical categories

Timeline (6)

🔄[human]Open → InProgress1 month ago
💬[human]1 month ago

Updated AGENTS.md to add a Tools category for Omni/Agent/Skills/*.md, included Omni/Agent/Roles/Reviewer.md in Agent skills, and added Biz/Skills/ReadHackerNews.md to Customer Development. Verified referenced skill paths exist. bild Omni/Agent/Skills.hs timed out twice (10 min).

💬[human]1 month ago

Synced AGENTS.md skill index with tool skills and Reviewer/ReadHackerNews entries.

🔄[human]InProgress → Done1 month ago