Skip to content

notque/vexjoy-agent / skills/meta/toolkit

toolkit

Verified

Toolkit management: create and evaluate skills and agents, manage routing tables, generate Claude.md.

FileKindSize
SKILL.mdskill md15.5 KB
agents/skill-creator/analyzer.mdmarkdown4.8 KB
agents/skill-creator/comparator.mdmarkdown4.7 KB
agents/skill-creator/grader.mdmarkdown3.9 KB
assets/skill-creator/eval_viewer.htmlother57.1 KB
references/agent-comparison.mdmarkdown11.5 KB
references/agent-comparison/benchmark-tasks.mdmarkdown6.8 KB
references/agent-comparison/do-creation-compliance-tasks.jsonconfig8.5 KB
references/agent-comparison/examples-and-errors.mdmarkdown1.0 KB
references/agent-comparison/grading-rubric.mdmarkdown4.3 KB
references/agent-comparison/methodology.mdmarkdown7.4 KB
references/agent-comparison/optimization-guide.mdmarkdown12.0 KB
references/agent-comparison/optimization-tasks.example.jsonconfig853 B
references/agent-comparison/optimize-phase.mdmarkdown9.3 KB
references/agent-comparison/read-only-ops-short-tasks.jsonconfig375 B
references/agent-comparison/report-template.mdmarkdown3.8 KB
references/agent-comparison/socratic-debugging-body-short-tasks.jsonconfig372 B
references/agent-comparison/socratic-debugging-trigger-tasks.jsonconfig2.8 KB
references/agent-creator.mdmarkdown10.9 KB
references/agent-creator/agent-design-patterns.mdmarkdown12.4 KB
references/agent-creator/agent-eval-design.mdmarkdown7.7 KB
references/agent-creator/agent-frontmatter-template.mdmarkdown9.3 KB
references/agent-evaluation.mdmarkdown10.6 KB
references/agent-evaluation/batch-evaluation.mdmarkdown1.6 KB
references/agent-evaluation/common-issues.mdmarkdown2.1 KB
references/agent-evaluation/report-templates.mdmarkdown2.2 KB
references/agent-evaluation/scoring-rubric.mdmarkdown2.4 KB
references/blind-ab-tests.mdmarkdown7.8 KB
references/generate-claudemd.mdmarkdown11.0 KB
references/generate-claudemd/CLAUDEMD_TEMPLATE.mdmarkdown4.1 KB
references/generate-claudemd/examples-and-errors.mdmarkdown7.4 KB
references/github-profile-rules.mdmarkdown7.5 KB
references/github-profile-rules/github-api-patterns.mdmarkdown8.2 KB
references/github-profile-rules/rule-categories.mdmarkdown4.8 KB
references/hook-development.mdmarkdown10.9 KB
references/hook-development/architecture.mdmarkdown3.7 KB
references/hook-development/code-examples.mdmarkdown9.4 KB
references/hook-development/preferred-patterns.mdmarkdown6.5 KB
references/hook-development/telemetry-database.mdmarkdown6.5 KB
references/routing-table-updater.mdmarkdown10.2 KB
references/routing-table-updater/batch-mode.mdmarkdown2.1 KB
references/routing-table-updater/conflict-resolution.mdmarkdown3.8 KB
references/routing-table-updater/error-handling.mdmarkdown1.9 KB
references/routing-table-updater/examples.mdmarkdown4.8 KB
references/routing-table-updater/extraction-patterns.mdmarkdown2.2 KB
references/routing-table-updater/routing-format.mdmarkdown3.6 KB
references/routing-table-updater/skill-examples.mdmarkdown2.7 KB
references/skill-composer.mdmarkdown9.1 KB
references/skill-composer/compatibility-matrix.mdmarkdown13.0 KB
references/skill-composer/composition-patterns.mdmarkdown4.9 KB
references/skill-composer/examples.mdmarkdown17.1 KB
references/skill-composer/skill-patterns.mdmarkdown12.5 KB
references/skill-creator.mdmarkdown28.9 KB
references/skill-creator/agent-template.mdmarkdown18.5 KB
references/skill-creator/artifact-schemas.mdmarkdown8.2 KB
references/skill-creator/bundled-components.mdmarkdown2.3 KB
references/skill-creator/complexity-tiers.mdmarkdown8.0 KB
references/skill-creator/domain-research-targets.mdmarkdown13.2 KB
references/skill-creator/enrichment-workflow.mdmarkdown9.9 KB
references/skill-creator/error-catalog.mdmarkdown9.9 KB
references/skill-creator/preferred-patterns.mdmarkdown11.7 KB
references/skill-creator/progressive-disclosure.mdmarkdown8.5 KB
references/skill-creator/skill-template.mdmarkdown14.6 KB
references/skill-creator/workflow-patterns.mdmarkdown7.6 KB
references/system-upgrade.mdmarkdown11.0 KB
references/system-upgrade/component-audit-checklists.mdmarkdown8.4 KB
references/system-upgrade/upgrade-failure-modes.mdmarkdown8.7 KB
references/system-upgrade/upgrade-signal-parsing.mdmarkdown7.3 KB
references/toolkit-evolution.mdmarkdown14.5 KB
references/toolkit-evolution/diagnose-scripts.mdmarkdown9.5 KB
references/toolkit-evolution/evolution-history.mdmarkdown5.5 KB
references/toolkit-evolution/evolution-report-template.mdmarkdown716 B
references/toolkit-evolution/evolve-preferred-patterns.mdmarkdown6.9 KB
references/toolkit-evolution/evolve-scripts.mdmarkdown3.7 KB
references/toolkit-governance.mdmarkdown16.0 KB
references/toolkit-governance/adr-lifecycle.mdmarkdown10.9 KB
references/toolkit-governance/frontmatter-compliance.mdmarkdown11.1 KB
references/toolkit-governance/hook-standardization.mdmarkdown21.5 KB
references/toolkit-governance/routing-table-patterns.mdmarkdown11.6 KB
references/weak-model-uplift.mdmarkdown10.3 KB
scripts/agent-comparison/compare.pyscript2.3 KB
scripts/agent-comparison/generate_variant.pyscript19.6 KB
scripts/agent-comparison/optimize_loop.pyscript89.3 KB
scripts/agent-comparison/trigger_eval.pyscript19.5 KB
scripts/routing-table-updater/extract_metadata.pyscript10.8 KB
scripts/routing-table-updater/generate_routes.pyscript10.5 KB
scripts/routing-table-updater/scan.pyscript4.7 KB
scripts/routing-table-updater/update_routing.pyscript12.4 KB
scripts/routing-table-updater/validate.pyscript7.3 KB
scripts/skill-composer/build_dag.pyscript12.5 KB
scripts/skill-composer/discover_skills.pyscript12.1 KB
scripts/skill-composer/validate.pyscript12.3 KB
scripts/skill-creator/aggregate_benchmark.pyscript10.0 KB
scripts/skill-creator/eval_compare.pyscript10.2 KB
scripts/skill-creator/optimize_description.pyscript12.5 KB
scripts/skill-creator/package_results.pyscript7.8 KB
scripts/skill-creator/run_eval.pyscript6.3 KB

references/routing-table-updater/conflict-resolution.md

View on GitHub
# Routing Conflict Resolution

## Conflict Types

### Type 1: Exact Pattern Overlap
**Example:** "debug" matches both systematic-debugging skill AND programming skill (golang-general.md)

**Resolution Strategy:**
- More specific pattern takes precedence
- Context-dependent patterns noted in description
- General pattern as fallback

**Action:**
```
Pattern: "debug" → systematic-debugging skill (general)
Pattern: "debug Go" → programming skill (golang-general.md) (specific)
Pattern: "debug Python" → programming skill (python-general.md) (specific)
```

### Type 2: Subset Pattern Overlap
**Example:** "test" is subset of "test API", "test Go", etc.

**Resolution Strategy:**
- Longer pattern matches first
- Routing logic checks longest match
- Document substring relationships

**Action:**
```
Pattern: "test API" → api-testing-skill (specific)
Pattern: "test Go" → programming (golang-general.md) + test-driven-development (specific)
Pattern: "test" → test-driven-development skill (general fallback)
```

### Type 3: Synonym Conflicts
**Example:** "review" vs "audit" vs "check" all mean similar things

**Resolution Strategy:**
- Map synonyms to same route
- Use most common term as primary pattern
- List alternates as comma-separated triggers

**Action:**
```
Pattern: "review", "audit", "check quality" → systematic-code-review skill
```

### Type 4: Domain Ambiguity
**Example:** "API" could be REST API, GraphQL, or general API work

**Resolution Strategy:**
- Domain-specific routing takes precedence over task routing
- If domain context present, route to domain agent
- Otherwise route to task-specific skill

**Action:**
```
If request includes "Go" + "API" → programming skill, golang-general.md (domain)
If request includes "test" + "API" → api-testing-skill (task)
If request is just "API" → Ask clarifying question
```

## Priority Rules

**Rule 1: Specificity Wins**
- "debug Go code" beats "debug"
- Domain + task beats task alone

**Rule 2: Domain Routing > Intent Routing**
- If domain keyword detected, check Domain-Specific table first
- Intent patterns are fallback for cross-domain tasks

**Rule 3: Explicit > Inferred**
- Manual routing entries always win over auto-generated
- User can override conflicts by adding manual entry

**Rule 4: Alphabetical Tiebreaker**
- If equal specificity, alphabetically first route wins
- Document the tie in comments

## Conflict Severity Levels

**Low Severity:**
- Both routes would work reasonably well
- User can clarify if needed
- Example: "test" → TDD skill vs testing skill (testing-automation.md)

**Medium Severity:**
- Routes lead to different outcomes
- Requires pattern refinement
- Example: "review" → code review vs documentation review

**High Severity:**
- Routes are incompatible
- One will fail user's intent
- MUST resolve before deploying
- Example: "deploy" → docker-deployment vs kubernetes-deployment (completely different)

## Resolution Process

1. **Detect Conflict:**
   ```python
   if pattern in routing_table and new_route != existing_route:
       conflicts.append(Conflict(pattern, [existing, new]))
   ```

2. **Analyze Specificity:**
   ```python
   specificity_score = len(pattern.split()) + domain_bonus + task_bonus
   higher_score_wins()
   ```

3. **Apply Priority Rules:**
   - Check manual entry status (manual always wins)
   - Check domain context
   - Check pattern length
   - Check alphabetical order

4. **Document Decision:**
   ```markdown
   <!-- ROUTING NOTE: "debug" has multiple routes
        - General debugging → systematic-debugging skill
        - Go debugging → programming skill (golang-general.md)
        Resolution: Context-dependent, domain routing takes precedence
   -->
   ```

5. **Update Routing Tables:**
   - Keep most specific patterns
   - Document fallback behavior
   - Add clarifying examples to /do documentation
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: 471kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall