| name | skill-auto-discovery |
| effort | low |
| description | After completing a complex task, check whether the sequence of steps used represents a recurring pattern worth codifying into a skill. Logs skill candidates to the bus for weekly review by an agent. |
| triggers | ["skill candidate","repeated pattern","should this be a skill","codify this","skill discovery"] |
Skill Auto-Discovery
After any task that required 5+ tool calls or a non-obvious sequence of decisions, run this checklist. The goal is to catch repeating workflows before they calcify into tribal knowledge.
When to Run
Run automatically after completing any task where:
- Total tool calls exceeded 5
- You made a non-trivial routing decision not covered by existing skills
- You handled an edge case by improvising (vs. following a defined rule)
- You found yourself repeating a sequence you've done before
Also runs as part of the weekly reflection scan (see self-evaluation-triage skill).
Detection Checklist
Before logging a skill candidate, verify it meets at least 2 of these 4 criteria:
| # | Criterion | Check |
|---|
| 1 | Same sequence of tool calls used 2+ times in the last 30 days | grep daily memory files for similar task patterns |
| 2 | Decision tree with 3+ branches applied manually more than once | was there a multi-step if/then that didn't map to any existing skill? |
| 3 | Vendor selection heuristic applied 3+ times without a written rule | did you pick a vendor based on unwritten knowledge? |
| 4 | Edge case handled outside any existing skill | something new happened and you figured it out on the fly |
If 0 or 1 criteria match: log nothing. Not every task needs a skill.
Logging a Skill Candidate
When 2+ criteria match:
cortextos bus log-event quality skill_candidate info \
--meta "{
\"proposed_name\": \"<kebab-case-name>\",
\"description\": \"<one sentence: what it does>\",
\"trigger_tasks\": [\"<task_id_1>\", \"<task_id_2>\"],
\"evidence\": \"<what pattern was observed>\",
\"effort_estimate\": \"low|medium|high\",
\"agent\": \"<your-agent>\"
}"
Then write a one-line entry to today's memory file:
- SKILL CANDIDATE: <proposed_name> — <description>. Evidence: <tasks>. Effort: <low/medium/high>
Do NOT build the skill yourself. an agent reviews candidates weekly and decides what to build.
Weekly Surface (runs as part of weekly reflection scan)
On Monday morning, pull all skill_candidate events from the past 7 days:
cortextos bus list-events --type quality --subtype skill_candidate --since 7d --format json
If any candidates exist, send a message to an agent:
cortextos bus send-message an agent normal "Weekly skill candidates from Blue: <count> candidates logged this week. Top candidates: <list proposed_name + description for top 3>. Full list in activity log."
If no candidates: no message needed.
What Makes a Good Skill
A skill candidate is worth building when:
- It would save >10 min of reasoning per occurrence
- It occurs at least 2–3x per week
- It has clear inputs and outputs
- It does not require David's judgment to execute
A candidate is NOT worth building when:
- It's a one-off edge case
- It requires judgment that belongs to David
- An existing skill already covers it with minor extension
Guardrails
- Never propose a skill that bypasses an approval workflow
- Never propose a skill that touches tenant personal data without explicit rules
- Candidates are suggestions only — an agent decides whether to build
- Do not log the same pattern twice in one week
Pair with self-evaluation-triage for post-meld reflection. Pair with the tasks skill for tracking what patterns produce the most backlog.
