AGENT SKILL

stellar-help

Analyzes current state and user query to answer BMad questions or recommend the next skill(s) to use. Use when user asks for help, bmad help, what to do next, or what to start with in BMad.

License 许可
MIT
所属仓库
ozioziel/Workville
最近更新
2026-11-11
Stars
★ 3
Forks
0

01 前言 Front Matter

name
stellar-help
description
Analyzes current state and user query to answer BMad questions or recommend the next skill(s) to use. Use when user asks for help, bmad help, what to do next, or what to start with in BMad.

03 SKILL.md 正文

BMad Help

Purpose

Help the user understand where they are in their BMad workflow and what to do next, and also answer broader questions when asked that could be augmented with remote sources such as module documentation sources.

Desired Outcomes

When this skill completes, the user should:

  1. Know where they are — which module and phase they're in, what's already been completed
  2. Know what to do next — the next recommended and/or required step, with clear reasoning
  3. Know how to invoke it — skill name, menu code, action context, and any args that shortcut the conversation
  4. Get offered a quick start — when a single skill is the clear next step, offer to run it for the user right now rather than just listing it
  5. Feel oriented, not overwhelmed — surface only what's relevant to their current position; don't dump the entire catalog
  6. Get answers to general questions — when the question doesn't map to a specific skill, use the module's registered documentation to give a grounded answer

Data Sources

  • Catalog: {project-root}/.stellar-build/_config/stellar-help.csv — assembled manifest of all installed module skills
  • Config: config.yaml and user-config.yaml files in {project-root}/.stellar-build/ and its subfolders — resolve output-location variables, provide communication_language and project_knowledge
  • Artifacts: Files matching outputs patterns at resolved output-location paths reveal which steps are possibly completed; their content may also provide grounding context for recommendations
  • Project knowledge: If project_knowledge resolves to an existing path, read it for grounding context. Never fabricate project-specific details.
  • Module docs: Rows with _meta in the skill column carry a URL or path in output-location pointing to the module's documentation (e.g., llms.txt). Fetch and use these to answer general questions about that module.

CSV Interpretation

The catalog uses this format:

module,skill,display-name,menu-code,description,action,args,phase,preceded-by,followed-by,required,output-location,outputs

Phases determine the high-level flow:

  • anytime — available regardless of workflow state
  • Numbered phases (1-analysis, 2-planning, etc.) flow in order; naming varies by module

Sequencing determines recommended ordering within and across phases (these are soft suggestions, not hard gates — see required for gating):

  • preceded-by — skills that should ideally complete before this one
  • followed-by — skills that should ideally run after this one
  • Format: skill-name for single-action skills, skill-name:action for multi-action skills

Required gates:

  • required=true items must complete before the user can meaningfully proceed to later phases
  • A phase with no required items is entirely optional — recommend it but be clear about what's actually required next

Completion detection:

  • Search resolved output paths for outputs patterns
  • Fuzzy-match found files to catalog rows
  • User may also state completion explicitly, or it may be evident from the current conversation

Descriptions carry routing context — some contain cycle info and alternate paths (e.g., "back to DS if fixes needed"). Read them as navigation hints, not just display text.

Response Format

For each recommended item, present:

  • [menu-code] Display name — e.g., "[PR] PRD"
  • Skill name in backticks — e.g., prd
  • For multi-action skills: action invocation context — e.g., "tech-writer lets create a mermaid diagram!"
  • Description if present in CSV; otherwise your existing knowledge of the skill suffices
  • Args if available

Ordering: Show optional items first, then the next required item. Make it clear which is which.

Constraints

  • Present all output in {communication_language}
  • Recommend running each skill in a fresh context window
  • Match the user's tone — conversational when they're casual, structured when they want specifics
  • If the active module is ambiguous, retrieve all meta rows remote sources to find relevant info also to help answer their question

04 同仓库更多 Skills

ozioziel
ozioziel/Workville

zk-proofs

Zero-knowledge proofs and privacy patterns on Stellar. Covers Groth16 verification in smart contracts via BLS12-381 host functions (CAP-0059, available), the BN254 + Poseidon proposals (CAP-0074/0075, status-sensitive), and concrete toolchain walkthroughs for Circom (on-chain verifiable today), Noir, and RISC Zero (attestation pattern until BN254 lands). Use when building privacy-preserving applications, ZK-verifier contracts, or wiring a proving toolchain to Stellar.

★ 3
ozioziel
ozioziel/Workville

tyler-architect

System architect and technical design leader. Use when the user asks to talk to Tyler or requests the architect.

★ 3
ozioziel
ozioziel/Workville

stellar-help

Analyzes current state and user query to answer BMad questions or recommend the next skill(s) to use. Use when user asks for help, bmad help, what to do next, or what to start with in BMad.

★ 3
ozioziel
ozioziel/Workville

stellar-competitive-landscape

Map the competitive landscape for a Stellar project idea. Use when a user says "who are my competitors on Stellar", "competitive analysis Stellar", "what already exists in this space on Stellar", "show me similar Stellar projects", "is anyone else building this on Stellar", "map the Stellar landscape for X" — or the Spanish/mixed-language equivalents, e.g. "cual es la competencia de X", "que tan saturado está este espacio", "que aspectos están menos explorados y la SDF/SCF están dispuestos a fondear", or "analiza la competencia de estos bounties". Also fires when a user (directly, or via a BMAD persona like justin-analyst) names a specific protocol/idea inline and asks about its competition, viability, or market whitespace — including "should we integrate [external protocol]" or "does anything like this already exist on Stellar" research, where the deliverable is the same landscape map applied to a build-vs-integrate decision. Queries the 728-project LumenLoop ecosystem database and Electric Capital developer activity to rank competitors by SCF funding history and repo activity.

★ 3
ozioziel
ozioziel/Workville

standards

Stellar standards, ecosystem, and reference. Covers SEPs (Stellar Ecosystem Proposals), CAPs (Core Advancement Proposals), and a quick map for picking the right standard for wallets, anchors, payments, deposits/withdrawals, federation, deep links, and KYC. Also bundles ecosystem references (DeFi protocols, dev tools, wallets, infra, community projects), curated documentation links, and MCP servers (live tools such as Raven). Use when you need to know which SEP applies, or want a starting point for ecosystem integrations, official docs, or live MCP tooling.

★ 3
ozioziel
ozioziel/Workville

smart-contracts

Stellar smart contract development (Rust, soroban-sdk). Entry point with project setup, contract anatomy, and build/deploy workflow, routing to three companion files in this directory — development.md (storage/TTL, authorization, cross-contract calls, tokens, events, errors, upgrades, fees, troubleshooting), testing.md (unit, fuzz, property, fork, mutation, integration), and security.md (vulnerability classes, checklists, tooling, audits). Use when writing, testing, reviewing, securing, debugging, or shipping Stellar smart contracts, including anything the user calls "Soroban" — Soroban contracts, soroban-sdk, Soroban auth/storage/TTL errors, SEP-41 tokens, or SAC integration from contract code.

★ 3