pulumi-esc
Guidance for working with Pulumi ESC (Environments, Secrets, and Configuration). Use when users ask about managing secrets, configuration, environments, short-term credentials, configuring OIDC for AWS, Azure, GCP, integrating with secret stores (AWS Secrets Manager, Azure Key Vault, HashiCorp Vault, 1Password), or using ESC with Pulumi stacks.
90
87%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Risky
Do not use without reviewing
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong skill description with excellent trigger term coverage and clear 'when to use' guidance. Its main weakness is the somewhat vague 'Guidance for working with' framing instead of listing specific concrete actions the skill enables. The distinctiveness is excellent due to the specific product focus on Pulumi ESC.
Suggestions
Replace 'Guidance for working with' with specific action verbs like 'Configure OIDC providers, manage secrets and environments, integrate with secret stores, and set up short-term credentials using Pulumi ESC.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Pulumi ESC) and mentions several areas like managing secrets, configuration, environments, short-term credentials, and OIDC configuration, but uses the vague framing 'Guidance for working with' rather than listing concrete actions (e.g., 'configure OIDC providers', 'retrieve secrets', 'create environments'). | 2 / 3 |
Completeness | The description clearly answers both 'what' (working with Pulumi ESC for secrets, configuration, environments, OIDC, secret store integrations) and 'when' with an explicit 'Use when...' clause listing specific trigger scenarios. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'secrets', 'configuration', 'environments', 'OIDC', 'AWS', 'Azure', 'GCP', 'AWS Secrets Manager', 'Azure Key Vault', 'HashiCorp Vault', '1Password', 'Pulumi stacks', 'short-term credentials', and 'ESC'. These are all terms users would naturally use when seeking help in this domain. | 3 / 3 |
Distinctiveness Conflict Risk | The description is highly specific to Pulumi ESC, a distinct product/tool. The combination of 'Pulumi ESC' with specific integrations (AWS Secrets Manager, Azure Key Vault, etc.) and use cases (OIDC configuration, Pulumi stacks) creates a clear niche that is unlikely to conflict with other skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill that provides actionable CLI commands, concrete YAML examples, and clear workflows with validation steps. Its main weakness is some unnecessary introductory content (the 'What is ESC?' section) that explains capabilities Claude doesn't need spelled out. Overall, it effectively balances breadth of coverage with progressive disclosure to external documentation.
Suggestions
Remove or significantly trim the 'What is ESC?' bullet list — Claude doesn't need a feature overview to use the skill effectively; the actionable sections already demonstrate these capabilities.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'What is ESC?' bullet list explains capabilities Claude could infer from context. The opening sentence is also somewhat redundant given the skill title and description. However, the CLI commands and examples are efficiently presented without excessive explanation. | 2 / 3 |
Actionability | Provides fully executable CLI commands, concrete YAML examples, specific URLs for documentation fetching, and clear troubleshooting steps with exact commands. The guidance is copy-paste ready throughout. | 3 / 3 |
Workflow Clarity | Multi-step processes like AWS OIDC setup and environment creation are clearly sequenced with numbered steps. Validation checkpoints are explicitly included (e.g., 'Validate: Help them test with pulumi env get or pulumi preview'). The complex tasks workflow includes understanding goals, checking setup, fetching docs, providing guidance, and validating. | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with essential information inline, then directs to specific external documentation URLs for detailed topics (provider integrations, syntax reference, CLI reference). References are one level deep and well-signaled with descriptive labels. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- pulumi/agent-skills
- Commit
3ec9d51
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.