by KodekaTeam
Build smarter. Work superior. An opinionated rule set for AI coding agents to create original interfaces, compelling content, and production-ready code.
# Add to your Claude Code skills
git clone https://github.com/KodekaTeam/superior-skillsGuides for using ai agents skills like superior-skills.
See how superior-skills compares with popular alternatives.
superior-skills is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by KodekaTeam. Build smarter. Work superior. An opinionated rule set for AI coding agents to create original interfaces, compelling content, and production-ready code. It has 50 GitHub stars.
superior-skills's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/KodekaTeam/superior-skills" and add it to your Claude Code skills directory (see the Installation section above).
superior-skills is primarily written in PowerShell. It is open-source under KodekaTeam on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh superior-skills against similar tools.
No comments yet. Be the first to share your thoughts!
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
references/.skills/ tree serves native plugin and standalone installations across supported coding agents.AGENTS.md; specialist details are loaded only when relevant.docs/implementation-timeline/ by default, with accepted intent and maintenance knowledge curated into existing guides or decisions when useful, unless the user opts out.superior-skills/
|-- VERSION
|-- CODE_OF_CONDUCT.md
|-- CONTRIBUTING.md
|-- SECURITY.md
|-- LICENSE
|-- AGENTS.md
|-- CLAUDE.md
|-- INSTALL.md
|-- plugin.json # Portable Agent Plugin and Antigravity marker
|-- gemini-extension.json # Gemini CLI extension
|-- kimi.plugin.json # Kimi Code plugin
|-- skills/ # Canonical portable skills
|-- scripts/ # Package validation
|-- .codex-plugin/ # Codex compatibility manifest
|-- .cursor-plugin/ # Cursor manifest and repository marketplace
|-- .claude-plugin/ # Claude Code manifest and marketplace
|-- principles/
| |-- README.md
| `-- documentation-continuity.md
`-- .agents/
`-- plugins/ # Codex repository marketplace
Superior can be installed as standalone Agent Skills through the Skills CLI or as a portable plugin through a supported host. Start a new agent session after installation.
Install from skills.sh with npx:
npx skills add KodekaTeam/superior-skills
The interactive installer lets you choose the skills, target agents, and project or global scope. Use the host-specific options below when you want the packaged plugin instead.
codex plugin marketplace add KodekaTeam/superior-skills
codex plugin add superior-skills@superior-skills
You can also add the repository from the Codex plugin marketplace UI and select Superior Skills.
Open Cursor Settings → Plugins, paste the repository URL below into the plugin search box, then install Superior Skills:
https://github.com/KodekaTeam/superior-skills
Run these commands inside Claude Code:
/plugin marketplace add KodekaTeam/superior-skills
/plugin install superior-skills@superior-skills
Install the repository as a native Gemini extension, then start a new session:
gemini extensions install https://github.com/KodekaTeam/superior-skills
Antigravity CLI can install the repository as a skill bundle:
agy plugin install https://github.com/KodekaTeam/superior-skills
For Antigravity IDE, copy the complete package into .agents/plugins/superior-skills/ for workspace scope or ~/.gemini/config/plugins/superior-skills/ for global scope.
Install the repository from the Kimi Code plugin manager, then run /reload or start a new session:
/plugins install https://github.com/KodekaTeam/superior-skills
.cline/skills/ or ~/.cline/skills/..agents/skills/, or import an existing Codex installation with muse skills import --from codex.skills-sh source with hermes skills search superior --source skills-sh.For agents without plugin support, copy the folders inside skills/ into the agent's project-level or user-level skills directory. For Codex-compatible project layouts, that directory is commonly .agents/skills/.
If the target already has an AGENTS.md or CLAUDE.md, merge the relevant sections instead of replacing project-specific commands and rules.
See INSTALL.md for local development, update, removal, and troubleshooting instructions. Step-by-step guides are also available in tutorial/english/.
Use the update method that matches the installation. Plugin installations keep their own cached copy, so refresh the marketplace and start a new session afterward.
npx skills update
codex plugin marketplace upgrade superior-skills
claude plugin marketplace update superior-skills
claude plugin update superior-skills@superior-skills
gemini extensions update superior-skills
Restart Gemini CLI after the extension update.
Update the installed plugin through Antigravity's plugin manager. For manually copied IDE packages, replace the existing superior-skills plugin directory with the latest repository contents.
Open /plugins, select Superior Skills, and use the available update action. Run /reload afterward.
Open Cursor Settings → Plugins, locate Superior Skills, and select the available update or reinstall action. Run Developer: Reload Window afterward.
Standalone copies do not update automatically; replace the installed superior-* skill folders with the latest folders from this repository.
Skills are selected automatically from the task context or can be invoked explicitly, for example with $superior-ux, $superior-code-review, $superior-delivery, or $superior-docs. The portable entrypoint is plugin.json, and canonical skill definitions live under skills/.
No. Superior is currently a skills-only plugin. It does not install an MCP server, lifecycle hook, credential, or external service.
Plugin hosts normally install a cached plugin package and read its root skills/ directory. Standalone hosts instead discover copied skills from their own project or user directories, such as .agents/skills/, .cline/skills/, or ~/.hermes/skills/.
Refresh or update the marketplace and start a new conversation or agent session. Existing sessions may retain the skill version loaded when the session began.
For material, verified implementation work, superior-docs instructs the agent to record a focused entry under docs/implementation-timeline/<feature>/ in the target project. It may also update a living implementation guide or decision when the current feature contract, criteria, invariants, or safe maintenance path changed. The instructions exclude raw prompts, chat transcripts, and hidden reasoning. An explicit request not to create documentation always takes precedence. Recording depends on the agent loading and following the instructions; Superior does not enforce it with a hook.
The plugin installs the complete package so routing and shared references remain consistent. For a standalone setup, individual superior-* folders can be copied, but any referenced files must be copied with them.
superior-copy?The copywriting skill is now named superior-copywriting. Update explicit $superior-copy references to $superior-copywriting. If you installed standalone skill folders manually, remove the old superior-copy folder and install the new one to avoid duplicate discovery.
Superior prioritizes:
The briefs and rationale used to develop the documentation workflow live in principles/. That directory is intended for package maintainers; portable runtime instructions live in skills/superior-docs/.
Explicit user instructions and more specific project rules always take precedence over this package's general preferences.