#!/usr/bin/env agent

Skill Creator

Create new skills for the agent system. Skills are markdown files that teach agents how to perform specific tasks.

What is a Skill?

A skill is a markdown file with:

1. #!/usr/bin/env agent shebang (makes it executable by the agent CLI)
2. Clear instructions for accomplishing a task
3. Examples and templates

Skills live in the repo, typically in Biz/Skills/ for business skills or other appropriate directories.

When to Create a Skill

Create a skill when:

• A task requires multiple steps that should be documented
• You find yourself explaining the same process repeatedly
• A workflow involves specific tools, APIs, or techniques worth capturing

Skill Format

#!/usr/bin/env agent

# Skill Name

Brief description of what this skill does and when to use it.

## Related Skills

Link to other skills this one depends on or complements.

## Input

What parameters/context the agent needs to execute this skill.

## Process

Step-by-step instructions. Be specific and actionable:
- Use imperative voice ("Do X" not "You should do X")
- Include actual commands, API calls, code snippets
- Show how to handle common edge cases

## Output Format

What the result should look like. Include a template if helpful.

## Example

A concrete worked example showing input -> process -> output.

Creating a Skill

Step 1: Identify the Need

Ask:

• What specific task does this skill accomplish?
• What knowledge is required that isn’t obvious?
• What are common mistakes to avoid?

Step 2: Choose Location

Skills go in appropriate directories:

• Biz/Skills/ - Business, sales, marketing skills
• Omni/Agent/ - Agent system skills
• Other domain-specific locations as needed

Step 3: Write the Skill

Create SkillName.md with:

# Create the file
cat > Biz/Skills/MySkill.md << 'EOF'
#!/usr/bin/env agent

# My Skill

[Content here]
EOF

# Make executable (optional, for direct execution)
chmod +x Biz/Skills/MySkill.md

Step 4: Add to AGENTS.md Index

Skills are discovered via the AGENTS.md index. Add an entry:

## Skills

- `Biz/Skills/MySkill.md` - Brief description

Step 5: Test

Run the skill directly or have the agent load it:

# Direct execution
./Biz/Skills/MySkill.md "test input"

# Or via agent CLI
_/bin/agent "Load Biz/Skills/MySkill.md and do X"

Best Practices

Keep Skills Focused

One skill = one task. If a skill is doing multiple unrelated things, split it.

Be Concrete

• ✅ curl -s "https://api.example.com/v1/items" | jq '.items[]'
• ❌ “Query the API and parse the response”

Include Real Examples

Show actual input/output, not hypothetical placeholders.

Link Related Skills

If skill A uses techniques from skill B, reference it:

## Related Skills
- `Biz/Skills/ParseReddit.md` - For extracting Reddit post data

Document Edge Cases

What happens when:

• The API is down?
• The data format is unexpected?
• Required input is missing?

Example Skills

See existing skills for reference:

• Biz/Skills/FindProspects.md - Search communities for potential customers
• Biz/Skills/ParseReddit.md - Extract data from Reddit JSON API
• Biz/Skills/ParseHackerNews.md - Extract data from HN Firebase API
• Biz/Skills/CompetitiveAnalysis.md - Research competitors