Sync AGENTS.md skill index with actual skill files

t-424·WorkTask·
·
·
Created3 months ago·Updated3 months ago·pipeline runs →

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 (1)

🔄[human]Open → Done3 months ago