ideogram-install-auth
Install and configure Ideogram API authentication. Use when setting up a new Ideogram integration, configuring API keys, or initializing Ideogram in your project. Trigger with phrases like "install ideogram", "setup ideogram", "ideogram auth", "configure ideogram API key".
68
83%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
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 solid, focused skill description for a narrow task. It clearly communicates what the skill does, when to use it, and provides explicit trigger phrases. The main weakness is that the 'what' could be slightly more specific about the concrete steps involved (e.g., installing packages, writing config files, validating keys).
Suggestions
Add more specific concrete actions to the 'what' portion, e.g., 'Installs the Ideogram SDK, stores API keys in environment variables, and validates authentication with a test request.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Ideogram API) and some actions (install, configure, authenticate), but doesn't list multiple concrete actions beyond setup-related tasks. It's somewhat specific but not comprehensive in detailing what steps or outputs are involved. | 2 / 3 |
Completeness | Clearly answers both 'what' (install and configure Ideogram API authentication) and 'when' (setting up a new integration, configuring API keys, initializing Ideogram) with explicit trigger phrases provided. | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would actually say: 'install ideogram', 'setup ideogram', 'ideogram auth', 'configure ideogram API key'. These are realistic phrases covering common variations of how a user would request this task. | 3 / 3 |
Distinctiveness Conflict Risk | Highly specific to Ideogram API setup and authentication. The niche is narrow and well-defined, making it very unlikely to conflict with other skills unless there are multiple Ideogram-related skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with clear step-by-step workflow and executable code examples in two languages. Its main weakness is including reference material (API URLs table, billing details, error codes) that bloats the install/auth focus and would be better placed in separate files. The core install and auth workflow is well-structured with proper validation.
Suggestions
Move the API Base URLs table, billing model details, and error handling table to a separate reference file (e.g., REFERENCE.md) and link to it, keeping SKILL.md focused on the install/auth workflow.
Trim the overview to just the essential auth mechanism ('Ideogram REST API authenticates via Api-Key header') without explaining what Ideogram does.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill includes some unnecessary content for Claude—the billing model details, the full API base URLs table, and the resources section add bulk that isn't essential for the install/auth task. The verification code is provided in both TypeScript and Python which is useful but adds length. The overview paragraph explaining what Ideogram is could be trimmed. | 2 / 3 |
Actionability | The skill provides fully executable, copy-paste ready code in both TypeScript and Python, specific bash commands for installation and configuration, and concrete steps for obtaining the API key. The verification scripts are complete and runnable. | 3 / 3 |
Workflow Clarity | The four steps are clearly sequenced (get key → install client → configure auth → verify connection), with Step 4 serving as an explicit validation checkpoint that includes error handling for failed auth. The .gitignore step provides a safety checkpoint for credential management. | 3 / 3 |
Progressive Disclosure | The content is reasonably structured with clear sections, but the API Base URLs table, billing model details, and error handling table are inline content that could be in separate reference files for a cleaner overview. The reference to 'ideogram-hello-world' as a next step is good, but the skill is somewhat monolithic for what should be a focused install/auth guide. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
a04d1a2
- 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.