Designing Skills for Argus

Build modular, task-specific AI agent skills that work across GitHub Copilot, Claude Code, and OpenCode.

Essential Principles

Capture Intent Before Writing

Interview first, write second.

Before drafting any skill files, gather concrete information about the task domain:

• What specific user requests should trigger this skill? Collect 5-10 example prompts.
• What does a good output look like? Get example inputs and expected outputs.
• What are the failure modes? What would "bad" output look like?
• Are there edge cases or ambiguous scenarios?

This front-loads the hardest design decisions. A skill written without intent capture produces generic guidance that doesn't match real usage patterns.