imMamdouhaboammar/chatgpt-codex-plugin-autopilot / skills/plugin-directory-listing-writer
plugin-directory-listing-writer
VerifiedUse when a validated ChatGPT/Codex Plugin needs accurate Plugin Directory fields, discovery metadata, starter prompts, and reviewer-facing listing details grounded in the packaged product.
Plugin Directory Listing Writer
Turn the exact Plugin artifact into clear public listing metadata. Treat listing copy as product metadata that affects both user understanding and model discovery.
Authority and freshness
Re-check the current official OpenAI Plugin submission, packaging, metadata, and guideline pages before finalizing a public listing. Portal fields and limits can change. Current official documentation overrides remembered limits and examples.
Required listing pack
Prepare these fields when the current portal requires them:
- Name
- Subtitle / short description
- Description / long description
- Category
- Developer name / verified developer identity
- Website URL
- Customer support URL
- Privacy policy URL
- Terms of Service URL
- Version
- Package name
- Capabilities
- logo asset
- starter prompts
- availability notes when relevant
- release notes
Use build_directory_pack.py to extract package-backed fields and expose missing portal-only material. Do not silently invent missing publisher or legal information.
Writing rules
Name
Use the customer-facing product or workflow name. Do not expose internal repository slugs unless they are already the public brand.
Subtitle
Describe the plain user function in one short line. Prefer a direct verb or outcome. Keep it within the current portal limit; when the form specifies 30 characters, enforce 30 characters rather than relying on a looser package limit.
Avoid claims such as "best", "perfect", "revolutionary", or unverifiable performance language.
Description
Explain:
- what users can do with the Plugin
- which repeatable workflows it covers
- what external data/actions it needs, if any
- material boundaries users should understand
Write from observable packaged behavior. Do not convert implementation detail into customer value claims.
Developer identity
The developer name must match the verified individual or business identity selected in the OpenAI Platform submission flow. Never infer a legal publisher name from a GitHub username, repository owner, email domain, or package author field.
URLs
Require public, accurate URLs. The support, privacy, terms, and website pages must match the actual publisher and data handling. Missing URLs are blockers for submission readiness when the current portal requires them.
Capabilities
Use short user-facing capability statements. Each capability should describe meaningful work the Plugin can actually perform. Remove duplicates and internal mechanics.
Starter prompts
Create prompts for the highest-value workflows, not cosmetic variants of the same request. Include direct and indirect phrasing where helpful. Test them against the final Plugin.
Discovery evaluation
Build a golden prompt set before final metadata sign-off:
- direct prompts that explicitly name the Plugin or workflow
- indirect prompts that describe the desired outcome
- negative prompts where the Plugin should not trigger
Record expected behavior for each prompt. Revise names/descriptions when recall or precision is poor rather than stuffing unrelated keywords into metadata.
Submission test material
When current OpenAI submission requirements call for reviewer test cases, prepare at least the required positive and negative cases. As of the 2026-08-22 baseline used by this repository, the official portal asks for at least five positive and three negative cases. Re-check before every submission.
Each positive case should state:
- user prompt
- expected Skill/tool/workflow behavior
- expected result shape
- fixture or account data required
Each negative case should state:
- prompt/scenario
- expected refusal, clarification, or fallback
- why the Plugin should not complete the action
Output
Produce a directory pack with:
- source commit/ref and version
- exact field values
- character-count checks where applicable
- asset paths
- starter prompts
- golden prompt evaluation set
- reviewer tests
- missing publisher/legal information
- claims that still need evidence
- status:
listing_readyornot_ready
Hand the pack to submission-pack-builder. Listing readiness is not submission, approval, or publication.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 469k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 321k | Updated | Claude CodeCodex | Verified | Install |