stark-ai-de/agent-skills / plugins/stark-ai-developer/skills/jev-capability-advisor
jev-capability-advisor
VerifiedRecommend available skills or MCP tools using TypeSafe Jev, or explicitly choose one next skill. Use when the user requests capability advice, candidate inspection, selection evaluation, or reusable host integration. Native client selection remains the default and fallback.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.6 KB |
| agents/openai.yaml | config | 615 B |
| assets/hook-guidance.txt | markdown | 1.1 KB |
| assets/openai-icon.png | binary | 15.2 KB |
| assets/openai-icon.svg | other | 504 B |
| assets/repository-hook-guidance.txt | markdown | 1.2 KB |
| references/contract.md | markdown | 24.8 KB |
| references/enabled-hook-entry.md | markdown | 3.6 KB |
| references/hook-catalog.md | markdown | 7.5 KB |
| references/hook-integration.md | markdown | 41.7 KB |
| references/network-access.md | markdown | 6.6 KB |
| references/script-inventory.md | markdown | 1.9 KB |
| references/session-integration.md | markdown | 10.7 KB |
| scripts/decision_cache.py | script | 4.5 KB |
| scripts/hook_catalog.py | script | 9.3 KB |
| scripts/https_transport.py | script | 14.0 KB |
| scripts/index_cache.py | script | 12.7 KB |
| scripts/jev_advisor.py | script | 48.2 KB |
| scripts/jev_hooks.py | script | 44.3 KB |
| scripts/jev_session.py | script | 18.5 KB |
| scripts/retrieval.py | script | 17.1 KB |
| scripts/routing_metadata.py | script | 3.3 KB |
scripts/routing_metadata.py
View on GitHub"""Optional public host guidance; never infer availability or permissions."""
TEXT_FIELDS = ('use_when', 'avoid_when', 'keywords')
MAX_ITEMS = 64
MAX_TEXT = 8192
def _text(value):
if not isinstance(value, str) or len(value) > MAX_TEXT:
raise ValueError('invalid_routing_metadata')
return ' '.join(value.split())
def guidance(item):
"""Validate optional fields and return compact, explicitly labeled values."""
result = {}
for key in TEXT_FIELDS:
if key not in item:
continue
value = item[key]
if isinstance(value, str):
values = [_text(value)]
elif isinstance(value, list) and len(value) <= MAX_ITEMS:
values = [_text(part) for part in value]
else:
raise ValueError('invalid_routing_metadata')
text = '; '.join(value for value in values if value)
if len(text) > MAX_TEXT:
raise ValueError('invalid_routing_metadata')
if text:
result[key] = text
if 'parameter_descriptions' in item:
value = item['parameter_descriptions']
if not isinstance(value, dict) or len(value) > MAX_ITEMS:
raise ValueError('invalid_routing_metadata')
parts = []
for name, description in value.items():
name, description = _text(name), _text(description)
if not name:
raise ValueError('invalid_routing_metadata')
if description:
parts.append((name, description))
text = '; '.join(name + ': ' + description for name, description in sorted(parts))
if len(text) > MAX_TEXT:
raise ValueError('invalid_routing_metadata')
if text:
result['parameter_descriptions'] = text
return result
def positive_text(item):
values = guidance(item)
# Avoid-conditions must never improve a candidate's lexical relevance.
return ' '.join(values[key] for key in ('use_when', 'keywords', 'parameter_descriptions') if key in values)
def selection_text(item, description, limit):
values = guidance(item)
if not values:
return description[:limit]
paths = item.get('source_paths', [])
if isinstance(paths, list):
for path in paths:
if isinstance(path, str) and path:
normalized = ' '.join(path.split())
if normalized:
values = {key: value.replace(normalized, '[local source]') for key, value in values.items()}
parts = [('description', description)] if description else []
parts.extend((key, values[key]) for key in ('use_when', 'avoid_when', 'keywords', 'parameter_descriptions') if key in values)
# Divide the card budget across supplied fields so a long positive field
# cannot consume all space before the avoid-condition is reached.
overhead = sum(len(key) + 2 for key, _ in parts) + 3 * max(0, len(parts) - 1)
if limit < overhead:
return ''
budgets = [0] * len(parts)
remaining = limit - overhead
while remaining and any(budgets[i] < len(value) for i, (_, value) in enumerate(parts)):
for i, (_, value) in enumerate(parts):
if remaining and budgets[i] < len(value):
budgets[i] += 1
remaining -= 1
rendered = ' | '.join(key + ': ' + value[:budgets[i]] for i, (key, value) in enumerate(parts))
return rendered[:limit]
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: 471k | 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 |