CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

openai-platform-api-key

Use when Codex is asked to build, run, test, debug, or configure an OpenAI-backed or provider-unspecified AI app, UI, script, CLI, generator, or tool, especially requests phrased only as "using AI" or generators driven by forms/user input; also use for OPENAI_API_KEY or sk-proj setup. Treat this as the credential gate: inspect safely, ask reuse-vs-new before API work, and never expose plaintext.

68

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

73%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable with a well-sequenced, checkpoint-rich workflow and a real, clearly signaled reference bundle. Its main weakness is token efficiency: the credential-gate rules are duplicated across Safety Rules, Mandatory First Step, Credential Decision Messages, and Workflow, inflating the context cost without adding information.

Suggestions

Consolidate the reuse-vs-new question, the hard-stop rule, and the 'prefer ignored/untracked env files' rule into a single authoritative section (e.g., Mandatory First Step) and reference it from Safety Rules and Workflow instead of restating each rule 2-4 times.

Merge 'Credential Decision Messages' into the Workflow's step 2 as the three message branches, removing the separate section that repeats the stop-until-answer and messaging constraints.

Move the detailed picker-turn mechanics (lines 103-109) into a short reference or the existing evals bundle, keeping only the tool name and end-of-turn rule in SKILL.md.

DimensionReasoningScore

Conciseness

The same rules are restated across four sections: the reuse-vs-new question appears in Mandatory First Step, Credential Decision Messages, and Workflow steps 2-3; "stop until the user answers" appears three times; "prefer ignored or untracked env files" appears in Safety Rules and Workflow step 1; the no-plaintext-printing rule appears in three forms. There is no concept-explanation padding, but the volume of duplicated rule blocks makes this 'noticeably verbose with several padded sections' (anchor 2) rather than 'some content that could be tightened' (anchor 3).

2 / 5

Actionability

Fully executable guidance: exact tool names and call shapes (`open_codex_api_key_setup` called with `{}`, `confirm_openai_api_key_local_destination`, `create_encrypted_openai_api_key`, connector id `connector_2de447f3f15448ebab48783d7e4f5d81`), copy-paste `node ... prepare/decrypt` commands with all flags, and a verbatim fallback question ("Save the new key to <path>? Reply yes to continue..."). Minor placeholders like "<plugin root>" are environment-specific, not gaps; anchor 5 fits.

5 / 5

Workflow Clarity

Steps 1-8 are clearly sequenced with explicit checkpoints and error branches: hard stop before the credential decision, tracked-file check with confirmation stop, tool preflight with retry after user reconnects, decline/cancel handling, refusal of symlink/out-of-workspace targets, and a final verification step. This is a single-target (not batch/destructive) write with a validate loop present, matching anchor 5; not 4 because no checkpoint is missing.

5 / 5

Progressive Disclosure

Structure is good: clear section headers, and the only bundle file, `references/evals.md` (verified to exist), is referenced one level deep in a dedicated References section with a one-line description. Not 5 because the ~135-line body keeps dense procedural detail inline (picker-turn mechanics, credential-decision message branches) that could partly live in a reference, leaving minor organization gaps per anchor 4.

4 / 5

Total

16

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with an explicit 'Use when...' clause, concrete natural-language triggers, and a clear statement of the credential-gate role and its safety posture. The only weakness is intentional breadth over provider-unspecified AI builds, which creates minor overlap with implementation skills.

DimensionReasoningScore

Specificity

Concrete actions are named — "inspect safely, ask reuse-vs-new before API work, and never expose plaintext" plus "OPENAI_API_KEY or sk-proj setup" — but coverage of what the skill does (secure key creation via the Platform connector, writing to a confirmed local destination) is only implied by "credential gate". Anchor 4 (several specific actions, minor gaps) fits better than 3 (only 1-2 actions) and better than 5 (comprehensive capability coverage).

4 / 5

Completeness

Both halves are explicit: what — "Treat this as the credential gate: inspect safely, ask reuse-vs-new before API work, and never expose plaintext"; when — an explicit "Use when Codex is asked to build, run, test, debug, or configure..." clause with concrete trigger phrases. Matches the anchor-5 example structure exactly; 4 would require the 'when' to be less explicit than it is.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered: "build, run, test, debug, or configure an OpenAI-backed or provider-unspecified AI app, UI, script, CLI, generator, or tool", "requests phrased only as 'using AI'", "generators driven by forms/user input", plus the exact tokens a user would type ("OPENAI_API_KEY", "sk-proj"). It includes synonyms and artifact-type variations the way the anchor-5 example includes "PDF files, PDFs, .pdf"; not 4 because no common natural variation of the request is conspicuously missing.

5 / 5

Distinctiveness Conflict Risk

The OpenAI-key/credential-gate niche is clear and "sk-proj"/"OPENAI_API_KEY" are distinctive triggers, but "provider-unspecified AI app, UI, script, CLI, generator, or tool" is deliberately broad and will overlap invocation territory with general app/frontend-implementation skills (the body confirms coordination with `build-web-apps:frontend-app-builder`). Mostly distinct with minor overlap risk against closely related skills — anchor 4, not 5.

4 / 5

Total

18

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

openai/plugins

Path

plugins/openai-developers/skills/openai-platform-api-key/SKILL.md

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.