LeoYeAI/agent-master-skills / skills/alexey-proactive-agent
proactive-agent
UnverifiedTransform AI agents from task-followers into proactive partners that anticipate needs and continuously improve. Now with WAL Protocol, Working Buffer, Autonomous Crons, and battle-tested patterns. Part of the Hal Stack π¦
| File | Kind | Size |
|---|---|---|
| SKILL-v2.3-backup.md | markdown | 19.7 KB |
| SKILL-v3-draft.md | markdown | 16.6 KB |
| SKILL.md | skill md | 20.4 KB |
| _meta.json | config | 304 B |
| assets/AGENTS.md | markdown | 3.8 KB |
| assets/HEARTBEAT.md | markdown | 2.9 KB |
| assets/MEMORY.md | markdown | 836 B |
| assets/ONBOARDING.md | markdown | 2.4 KB |
| assets/SOUL.md | markdown | 1.4 KB |
| assets/TOOLS.md | markdown | 1.0 KB |
| assets/USER.md | markdown | 926 B |
| references/onboarding-flow.md | markdown | 4.0 KB |
| references/security-patterns.md | markdown | 3.0 KB |
| scripts/security-audit.shexecutable | script | 4.0 KB |
references/onboarding-flow.md
View on GitHub# Onboarding Flow Reference
How to handle onboarding as a proactive agent.
## Detection
At session start, check for `ONBOARDING.md`:
```
if ONBOARDING.md exists:
if status == "not_started":
offer to begin onboarding
elif status == "in_progress":
offer to resume or continue drip
elif status == "complete":
normal operation
else:
# No onboarding file = skip onboarding
normal operation
```
## Modes
### Interactive Mode
User wants to answer questions now.
```
1. "Great! I have 12 questions. Should take ~10 minutes."
2. Ask questions conversationally, not robotically
3. After each answer:
- Update ONBOARDING.md (mark answered, save response)
- Update USER.md or SOUL.md with the info
4. If interrupted mid-session:
- Progress is already saved
- Next session: "We got through X questions. Continue?"
5. When complete:
- Set status to "complete"
- Summarize what you learned
- "I'm ready to start being proactive!"
```
### Drip Mode
User is busy or prefers gradual.
```
1. "No problem! I'll learn about you over time."
2. Set mode to "drip" in ONBOARDING.md
3. Each session, if unanswered questions remain:
- Ask ONE question naturally
- Weave it into conversation, don't interrogate
- Example: "By the way, I realized I don't know your timezone..."
4. Learn opportunistically from conversation too
5. Mark complete when enough context gathered
```
### Skip Mode
User doesn't want formal onboarding.
```
1. "Got it. I'll learn as we go."
2. Agent works immediately with defaults
3. Fills in USER.md from natural conversation
4. May never formally "complete" onboarding β that's fine
```
## Question Flow
Don't ask robotically. Weave into conversation:
β Bad: "Question 1: What should I call you?"
β
Good: "Before we dive in β what would you like me to call you?"
β Bad: "Question 5: What is your primary goal?"
β
Good: "I'd love to understand what you're working toward. What's the main thing you're trying to accomplish right now?"
## Opportunistic Learning
Even outside formal onboarding, notice and capture:
| User Says | Learn |
|-----------|-------|
| "I'm in New York" | Timezone: America/New_York |
| "I hate long emails" | Communication: brief |
| "My cofounder Sarah..." | Key person: Sarah (cofounder) |
| "I'm building an app for..." | Current project |
Update USER.md and mark corresponding onboarding question as answered.
## Handling Interruption
### Mid-Question Interruption
```
User: "Actually, hold on β need to take this call"
Agent: "No problem! We can pick this up anytime."
[Save progress, don't ask again this session]
```
### Multi-Day Gap
```
Session 1: Answered 4 questions, got interrupted
[3 days pass]
Session 2: "Hey! Last time we were getting to know each other.
Want to continue, or should I just ask occasionally?"
```
### User Seems Annoyed
```
If user seems impatient with questions:
- Stop asking
- Switch to opportunistic learning only
- Note in ONBOARDING.md: "User prefers organic learning"
```
## Completion Criteria
Onboarding is "complete enough" when you have:
**Minimum viable:**
- Name
- Primary goal or current project
- Communication preference (even if inferred)
**Ideal:**
- All 12 questions answered
- USER.md fully populated
- SOUL.md personality configured
**Reality:**
- Many users will never formally complete
- That's okay β agent adapts
- Keep learning from every interaction
## Post-Onboarding
When status changes to "complete":
1. Summarize what you learned:
```
"Okay, here's what I've got:
- You're [Name], based in [Timezone]
- You're working on [Project] toward [Goal]
- You prefer [communication style]
- Key people: [list]
Anything I got wrong or missed?"
```
2. Explain what's next:
```
"I'm now in proactive mode. I'll:
- Check in during heartbeats
- Look for ways to help without being asked
- Build things I think you'll find useful
I'll always check before doing anything external."
```
3. Transition to normal operation
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why β repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" β or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself β your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |