feat(skills): Add hierarchical structure with references and templates (#157)
* feat(skills): Add hierarchical structure with references and templates
Adds modular documentation and executable templates to the agent-browser skill
for better AI agent consumption and progressive disclosure.
## Added
### References (deep-dive documentation)
- `references/snapshot-refs.md` - Ref lifecycle, invalidation, troubleshooting
- `references/session-management.md` - Parallel sessions, state persistence
- `references/authentication.md` - Login flows, OAuth, 2FA patterns
- `references/video-recording.md` - Recording for debugging/docs
- `references/proxy-support.md` - Proxy configuration, geo-testing
### Templates (ready-to-use workflows)
- `templates/form-automation.sh` - Form filling with validation
- `templates/authenticated-session.sh` - Login once, reuse state
- `templates/capture-workflow.sh` - Content extraction with screenshots
## Modified
- `SKILL.md` - Added reference tables linking to new documentation
## Benefits
- Progressive disclosure: Load overview first, deep dives on demand
- Reduced context: Smaller chunks for better LLM token efficiency
- Ready workflows: Copy-paste templates for common patterns
* fix(templates): Make authenticated-session.sh runnable out-of-box
Addresses review feedback: login actions were commented but verification
wasn't, causing script to fail when run as-is.
New approach:
- DISCOVERY MODE runs first (shows form structure)
- LOGIN FLOW section is fully commented as a unit
- User runs once to see refs, then customizes
┌─────────────────────────────────────────────────────────────┐
│ LOGIN FORM STRUCTURE │
├─────────────────────────────────────────────────────────────┤
│ @e1 [input type="email"] │
│ @e2 [input type="password"] │
│ @e3 [button] "Sign In" │
└─────────────────────────────────────────────────────────────┘
Yonatan
f74924cd0c