🤖 SimpleContext-Agents

Ready-to-use agent definitions for SimpleContext
Drop a YAML file → get a fully-configured AI agent. No code needed.

---

📦 Available Agents

Core Agents

Agent	Description	Best For
🧠 general	Friendly general-purpose assistant	Everyday questions, auto-routing fallback
🖥️ coding	Expert programmer for all languages	Code, debug, review, refactor
🚀 devops	Server, deployment & infrastructure	Docker, CI/CD, Linux, cloud
✍️ writer	Professional content writer	Blog, copy, email, social media

Knowledge & Research

Agent	Description	Best For
🔍 researcher	Thorough fact-checker & researcher	Research, fact-checking, analysis
📚 tutor	Patient adaptive teacher	Learning any subject
📝 summarizer	Expert content condensation	Articles, reports, meetings
🌐 translator	Multi-language translator	Any language pair, cultural context

Business & Professional

Agent	Description	Best For
📊 analyst	Data & business analyst	Reports, KPIs, insights, forecasting
🎧 customer_service	Empathetic CS representative	Support, complaints, returns
💰 finance	Personal finance advisor	Budgeting, investing, financial planning
⚖️ legal	Legal information assistant	Contracts, rights, regulations

Lifestyle & Creativity

Agent	Description	Best For
🎨 creative	Brainstorming & creative partner	Ideation, storytelling, naming, worldbuilding
⚡ productivity	Personal productivity coach	Time management, habits, focus, goal-setting
💪 health	Wellness guide	Fitness, nutrition, sleep, mental health

---

🚀 Quick Install

# Clone this repo
git clone https://github.com/zacxyonly/SimpleContext-Agents.git

# Copy agents to your SimpleContext project
cp SimpleContext-Agents/agents/*.yaml your-project/agents/

That's it. SimpleContext hot-reloads agents — no restart needed.

With SimpleContext-Bot

Agents are auto-downloaded during setup:

simplecontext-bot setup
# Step 2/6: Downloads all agents automatically

Or update anytime:

simplecontext-bot update --agents-only

---

🤔 How Agents Work

Each .yaml file defines a complete agent:

agent.yaml
├── name          → unique identifier
├── description   → what this agent does
├── triggers      → keywords that auto-route to this agent
│   ├── keywords  → list of trigger words
│   └── priority  → higher = preferred when multiple agents match
├── personality   → system prompts per user level
│   ├── default   → for all users
│   ├── beginner  → for profile.level = "beginner"
│   ├── expert    → for profile.level = "expert"
│   └── indonesian→ for Indonesian-language responses
├── skills        → injected into system prompt
│   ├── name      → skill identifier
│   ├── content   → instructions for this skill
│   ├── priority  → order in prompt (higher = first)
│   ├── group     → for filtering skills
│   ├── tags      → for search and filtering
│   └── conditions → only activate if profile condition met
└── chain         → handoff rules to other agents
    ├── condition → keywords that trigger handoff
    └── to        → target agent name

---

📖 Guide: Create Your Own Agent

1. Minimal Agent (5 lines)

name: my_agent
description: What this agent does

triggers:
  keywords: [trigger1, trigger2]
  priority: 5

personality:
  default: You are a helpful assistant specialized in...

2. Full-Featured Agent

name: legal_advisor
description: Legal information and document helper

triggers:
  keywords:
    - contract
    - legal
    - law
    - agreement
    - clause
    - liability
    - jurisdiction
  priority: 8

personality:
  default: |
    You are a knowledgeable legal information assistant.
    Always clarify that you provide general information, not legal advice.
    Recommend consulting a licensed attorney for specific situations.
    Use clear, plain language to explain legal concepts.

  expert: |
    You are assisting a legal professional.
    Use proper legal terminology and cite relevant principles.
    Focus on nuance, jurisdiction specifics, and edge cases.

  indonesian: |
    Kamu adalah asisten informasi hukum yang berpengetahuan.
    Selalu jelaskan bahwa ini informasi umum, bukan nasihat hukum resmi.
    Sarankan konsultasi ke pengacara untuk kasus spesifik.

skills:
  - name: disclaimer
    description: Legal disclaimer
    content: |
      Always include when relevant:
      "Note: This is general legal information, not legal advice.
      For your specific situation, please consult a licensed attorney."
    priority: 20

  - name: document_review
    description: How to review legal documents
    content: |
      When reviewing contracts or legal documents:
      1. Identify the parties involved
      2. Highlight key obligations for each party
      3. Flag unusual or potentially unfavorable clauses
      4. Note missing standard protections
      5. Summarize termination and dispute resolution terms
    priority: 10
    tags: [contract, review]

chain:
  - condition: tax OR pajak OR accounting OR akuntansi
    to: analyst
    message: For tax and accounting questions, routing to our Analyst agent.

3. Personality Levels

Set profile.level in user profile to activate different personalities:

sc.memory(user_id).remember("level", "expert")
# Now the agent uses personality.expert instead of personality.default

Available by convention: default, beginner, intermediate, expert, indonesian, formal

4. Skill Conditions

Skills can be conditionally activated based on user profile:

skills:
  - name: advanced_tips
    content: Advanced tips for power users...
    conditions:
      profile.level: expert          # only for expert users

  - name: multi_level_condition
    content: Content for Python experts...
    conditions:
      profile.level: expert
      profile.lang: python           # AND user uses Python

5. Agent Chaining

Automatically handoff to another agent based on message content:

chain:
  - condition: deploy OR server OR docker    # keyword(s) in user message
    to: devops                               # target agent name
    message: Routing to DevOps agent.        # optional message to show user

Important: Chain is triggered by the user's message, not the LLM response.

---

💡 Agent Design Tips

1. Be specific with triggers

# ❌ Too generic
keywords: [help, question, ask]

# ✅ Domain-specific
keywords: [contract, legal, law, clause, liability]

2. Layer your personalities

personality:
  default: General instructions for everyone
  beginner: Simpler language, more examples, more encouragement
  expert: Skip basics, be technical, challenge assumptions

3. Use skill groups

skills:
  - name: output_format
    group: output           # structural skills
    priority: 20            # always at top

  - name: domain_knowledge
    group: knowledge        # domain-specific skills
    priority: 10

  - name: advanced_feature
    group: advanced
    conditions:
      profile.level: expert # only load for expert users

4. Set priority thoughtfully

• priority: 20 → always appears first (format rules, disclaimers)
• priority: 10 → middle (domain knowledge, methodology)
• priority: 5 → supporting details
• priority: 1 → rarely needed extras

5. Chain defensively

chain:
  # Only chain on very specific signals
  # Avoid generic words that appear in unrelated contexts
  - condition: deploy server nginx   # specific multi-word signal
    to: devops

---

🗂️ Project Structure

SimpleContext-Agents/
├── agents/
│   ├── general.yaml          ← default fallback agent
│   ├── coding.yaml           ← programmer expert
│   ├── devops.yaml           ← server & infrastructure
│   ├── writer.yaml           ← content & copywriting
│   ├── analyst.yaml          ← data & business
│   ├── customer_service.yaml ← CS & support
│   ├── translator.yaml       ← multi-language
│   ├── tutor.yaml            ← teacher & mentor
│   ├── researcher.yaml       ← research & fact-checking
│   ├── summarizer.yaml       ← content condensation
│   ├── finance.yaml          ← personal finance & investing
│   ├── legal.yaml            ← legal information
│   ├── creative.yaml         ← brainstorming & creativity
│   ├── productivity.yaml     ← time management & habits
│   └── health.yaml           ← fitness, nutrition, wellness
├── CONTRIBUTING.md
└── README.md

---

🤝 Contributing

Have a useful agent? Contributions welcome!

1. Fork this repo
2. Create agents/your_agent.yaml
3. Follow the agent format above
4. Test with SimpleContext
5. Submit a Pull Request

Please include in your PR:

• What the agent does
• Example use cases
• Trigger keywords used

---

🔗 Ecosystem

Repo	Description
SimpleContext	Core engine — Universal AI Brain
SimpleContext-Plugin	Plugin registry — extend with vector search and more
SimpleContext-Bot	Telegram Bot — auto-downloads these agents
SimpleContext-Agents	This repo

---

⭐ Star SimpleContext · Report Issues