s32sdaf-kb-entrypoint
Automatic KB-first entrypoint and router for SDAF / S32SDAF / Volkano-related requests. Detects direct and indirect SDAF intent from broad user prompts, consults the s32sdaf knowledge base for definit
Files1
View on GitHubSKILL.mdskills/s32sdaf/s32sdaf-kb-entrypoint/SKILL.md
GitHubS32SDAF KB Entrypoint
The automatic KB-first entrypoint for any SDAF / S32SDAF / Volkano request,
even when the user does not explicitly ask to search the knowledge base or name
the correct workflow. Interpret the request, consult the s32sdaf KB for
meaning/terminology, run safe status/discovery when context is missing, and
route to the correct downstream skill with minimal clarification.
When to use
Activate automatically whenever the prompt mentions or strongly implies SDAF,
S32SDAF, Volkano, smart card, secure debug authorization/authentication,
challenge-response, UID registration, ADKP, KUID, KUID_RF,
KUID_PRE_FA, ODAK, wrap key, register key, or authenticate device - or asks
a broad secure-debug onboarding/"what can I do"/"how does it work" question in
an S32SDAF context.
Do not use it to perform destructive mutations before intent is clear, to guess missing UID/key/password/challenge values, to bypass a dedicated downstream skill once intent is clear, or to invent acronym expansions when the KB is available.
Available Capabilities
| Type | Name | Invocation |
|---|---|---|
| Tool | nxp_knowledge_kb_list_corpora |
verify the s32sdaf corpus is available |
| Tool | nxp_knowledge_kb_search |
search s32sdaf for definitions/terminology/workflow |
| Tool | status |
verify MCP server reachability/config |
| Tool | execute_action(action="find_installation") |
locate Volkano install |
| Tool | execute_action(action="discover", params={...}) |
inspect registered UIDs/keys |
Do not jump to write-side tools from this skill unless intent is already clear and a downstream workflow has been selected.
KB-first rule
For any definitional, acronym-expansion, terminology, or explanatory prompt
involving SDAF / S32SDAF / Volkano / secure debug authorization/authentication,
query the s32sdaf KB before answering. Do not expand SDAF from memory
when the KB is available. If the KB has no exact expansion/definition, say so
explicitly and label any additional interpretation as inference. If KB and
memory conflict, prefer the KB and say so.
Quickstart
- Detect SDAF/S32SDAF/Volkano intent -> activate automatically.
- Explanatory/terminology prompt ->
nxp_knowledge_kb_searchons32sdaffirst, then answer with KB-grounded wording. - Operational and specific -> route immediately to the matching downstream skill.
- Operational but underspecified -> run safe discovery/status, or ask one concise routing question.
Workflow
- Detect intent automatically without waiting for an explicit KB-search request.
- Classify explanatory vs operational. Is the user asking for a definition/explanation, or to authenticate / register / wrap-and-register / inspect the environment?
- Explanatory -> KB first. Search
s32sdaf, prefer exact KB phrasing, add source references when useful. Summarize the available workflows (authentication, registration, wrap-and-register, discovery). - Operational and specific -> route:
- authentication ->
s32sdaf-auth-device(HSE2/scheme/OID-sensitive ->s32sdaf-hse2-authentication). - final registration-ready material ->
s32sdaf-register-key. - plain key needing wrapping ->
s32sdaf-wrap-and-register. - readiness / "which UIDs" / install path -> discovery/status tools.
- debug a secured/locked device from S32DS ("Target is secured",
Error 102/601, enable secure debugging) ->
s32sdaf-secure-debug-session.
- authentication ->
- Operational but ambiguous -> safe checks first. Prefer
status,execute_action(action="find_installation"), orexecute_action(action="discover", params={...}), then ask one concise routing question. - Keep clarification minimal - one short, high-value question at a time, not a full parameter interrogation.
Preferred clarification questions:
- "Are you asking what SDAF means, or do you want to perform an operation now?"
- "Authenticate a device, register a key, or inspect what is on the card?"
- "Do you already have a wrapped key, or need a plain key wrapped first?"
Guardrails
Scope - Usually read-oriented and low-risk: KB search, explanation, workflow selection, safe discovery/readiness checks. Persistent smart-card mutation should occur only after handing off to a downstream registration workflow.
Destructive actions - Do not delete or mutate the card from this skill.
Secrets - Do not request or echo UID/key/password/challenge values that the downstream workflow does not yet need.
Refuse-and-escalate -
- Vague request ("help with SDAF"): summarize workflows, ask one routing question, optionally suggest discovery first; if definitional, KB first.
- Environment/registration state unknown: prefer discovery over guessing.
- Ambiguous key path (ADKP vs wrapped vs plain-to-be-wrapped): ask one disambiguation question; do not guess from wording alone.
- KB hit missing/incomplete: say so, give the closest KB-grounded answer, label non-KB content as inference.
- User expects fully automatic execution from a vague prompt: explain that intent can be inferred, but UID/challenge/key/password must come from the user or environment.
Validation loop
- Confirm SDAF/S32SDAF/Volkano intent was recognized automatically.
- For explanatory prompts, confirm the KB was consulted before answering.
- Confirm the correct downstream skill was selected, or a safe discovery step chosen.
- Confirm clarification burden stayed minimal and no unsafe mutation occurred.
- Pass criterion: the user is either KB-grounded-answered or handed to the right downstream workflow with minimal friction.
Out of scope
- Performing destructive mutations directly (delegate to downstream skills).
- Deep per-workflow execution detail (that lives in the downstream skills).
- Inventing acronym expansions or terminology when the KB is available.
See Also
- Related skills:
s32sdaf-auth-device,s32sdaf-hse2-authentication,s32sdaf-register-key,s32sdaf-wrap-and-register,s32sdaf-discovery-and-status,s32sdaf-unified-get-response,s32sdaf-secure-debug-session(debug a secured device from S32DS).