Build an Agent Skill Stack

Build the smallest useful stack for the user's actual outcome. Never force a domain example or a fixed lifecycle onto a different request.

1. Choose the user-facing depth

Default to plain-language mode. Assume the user does not need to understand paths, revisions, hashes, manifests, static analysis, or runtime details.

In plain-language mode, show:

• what the user is trying to accomplish;
• the steps in everyday language;
• which capabilities are already available;
• which Skills are recommended, optional, overlapping, or unsuitable;
• how widely each candidate is used;
• whether it passed an installation safety check and a safe trial;
• what account access or external actions it may require.

Keep source paths, revisions, file fingerprints, raw scores, audit evidence, and dependency details in the internal record. Show them only when the user asks for technical details or when a specific technical fact is necessary for informed consent.