v2.4.1

Superior Skills v2.4.1

Version 2.4.1 improves design recreation, reference handling, and project documentation so agents can follow user intent more closely and retain useful context across sessions.

1. Highlights

• Improved visual fidelity when recreating a supplied design.
• Reduced reference and authoring residue in generated interfaces and copy.
• Extended superior-docs with curated implementation memory for future development and maintenance.

2. What's changed

Changed

• Added a design recreation guide for matching reference layouts, typography, spacing, colors, and visual hierarchy.
• Added curated implementation memory to record accepted intent, criteria, decisions, and maintenance context alongside verified outcomes.

Improved

• Clarified how agents should distinguish a request for visual recreation from a request for inspiration.
• Improved visual verification guidance, including comparing rendered output with the reference and reporting necessary deviations.
• Strengthened guidance for handling third-party identities, content, assets, licenses, and required notices.
• Updated English and Indonesian documentation to explain the curated memory workflow.

Fixed

• Addressed guidance that could lead agents to redesign or remove parts of an explicitly requested reference without a clear reason.
• Reduced the chance that template branding, demo content, or notes about future content appear in finished product copy.

3. Breaking changes and migration

There are no breaking changes in v2.4.1. Existing v2.4.0 installations can update normally, with no skill-directory or configuration migration required.

4. Full changelog

v2.4.0...v2.4.1

v2.4.0

Superior Skills v2.4.0

Version 2.4.0 expands Superior Skills across additional AI coding environments and improves the repository workflows used to report issues and contribute changes.

1. Highlights

• Added native package metadata for Gemini CLI and Kimi.
• Added installation and update guidance for Gemini, Antigravity, Cline, Muse, Hermes, and Kimi.
• Added structured GitHub issue and pull request templates for clearer bug reports, feature proposals, platform-support requests, questions, and contributions.

2. What's changed

Changed

• Added gemini-extension.json and kimi.plugin.json while keeping the canonical skill collection under skills/.
• Expanded the English and Indonesian README files and the installation guide with host-specific setup, update, removal, and troubleshooting instructions.
• Added dedicated GitHub templates for bug reports, feature requests, platform-support requests, questions, and pull requests.

Improved

• Extended package validation to cover six plugin manifests and verify Kimi's canonical skill path.
• Clarified which hosts use native plugin manifests and which can consume Superior Skills through standard agent-skill directories or Skills CLI workflows.
• Improved issue intake by disabling unstructured blank issues and directing each request to the appropriate template.

Fixed

• Closed validation and documentation gaps that previously left Gemini, Kimi, Antigravity, Cline, Muse, and Hermes without complete host-specific guidance.
• Synchronized version metadata across the portable, Codex, Claude, Cursor, Gemini, and Kimi plugin configurations.

3. Breaking changes and migration

There are no breaking changes in v2.4.0. Existing v2.3.0 installations can update normally, with no skill-directory or configuration migration required.

Users adopting a newly documented host should follow the corresponding setup instructions in INSTALL.md.

4. Full changelog

v2.3.0...v2.4.0

v2.3.0

Superior Skills v2.3.0

Version 2.3.0 strengthens how Superior Skills handles semantic interfaces, readable typography, design recreation, and complexity reduction without expanding the skill count.

1. Highlights

• Added semantic HTML and search-discovery guidance for public pages while keeping private application interfaces outside unnecessary SEO requirements.
• Improved typography decisions so design recreation preserves hierarchy without blindly copying small text from screenshots.
• Strengthened superior-lean with safer abstraction removal, indirect-consumer checks, and total dependency ownership analysis.

2. What's changed

Changed

• Added a focused semantic HTML and search-discovery reference to superior-ui and connected it with responsive and accessibility concerns.
• Added a complexity-decisions and safe-removal reference to superior-lean.
• Strengthened the shared agent contract around reuse, minimum sufficient implementation, risk-based testing, and required safeguards.

Improved

• Added practical typography baselines for projects without an established type scale while preserving existing design tokens when available.
• Improved design-recreation guidance to account for screenshot scaling, browser zoom, device pixel ratio, and unavailable source fonts.
• Clarified that responsive layouts should preserve one authoritative semantic hierarchy instead of duplicating hidden desktop and mobile content.
• Improved dependency-removal decisions by comparing complete behavior and long-term ownership rather than visible line count alone.

3. Breaking changes and migration

There are no breaking changes in v2.3.0. Existing v2.2.0 installations can update normally, with no skill-directory or configuration migration required.

4. Full changelog

v2.2.0...v2.3.0

v2.2.0

Superior Skills v2.2.0

Version 2.2.0 introduces a dedicated UX workflow and makes Superior Skills easier to install and update through the Skills CLI ecosystem.

1. Highlights

• Added superior-ux for evidence-based user journeys, information architecture, task flows, interaction feedback, and recovery design.
• Added installation and update guidance for Skills CLI and skills.sh.
• Expanded Superior Skills from 17 to 18 focused skills.

2. What's changed

Changed

• Added the canonical superior-ux skill with focused references for journey design, interaction recovery, and UX evaluation.
• Added English and Indonesian tutorials, routing guidance, and plugin metadata for the new UX workflow.
• Updated README and installation documentation with Skills CLI commands and supported installation scopes.

Improved

• Clarified ownership between UX composition, visual UI implementation, application logic, responsive behavior, accessibility, copy, and testing.
• Improved UX guidance by separating observed evidence from assumptions and preventing unsupported personas, research findings, or usability claims.
• Made installation and updates more accessible for users who prefer npx skills or skills.sh over manual copying.

Fixed

• Resolved ambiguous routing between user-journey design, interface styling, and application behavior by assigning each concern to its owning skill.

3. Breaking changes and migration

There are no breaking changes in v2.2.0. Existing v2.1.0 installations can update normally.

Projects that maintain a manually copied skill set should add the new skills/superior-ux/ directory to receive the UX workflow.

4. Full changelog

v2.1.0...v2.2.0

v2.1.0

Superior Skills v2.1.0

Version 2.1.0 expands Superior Skills with broader engineering coverage, clearer skill boundaries, and more reliable plugin distribution.

1. Highlights

• Expanded the collection from 10 to 17 focused engineering skills.
• Improved routing between implementation, review, debugging, performance, delivery, and reliability workflows.
• Strengthened plugin validation, marketplace installation, and visual branding.

2. What's changed

Changed

• Added dedicated skills for testing, debugging, database work, performance, code review, delivery, and reliability.
• Added English and Indonesian guidance for the new workflows.
• Updated marketplace metadata and plugin assets for supported hosts.

Improved

• Refined accessibility, API security, documentation, application logic, and responsive-design guidance.
• Clarified cross-skill routing so agents load only the workflows relevant to the task.
• Expanded package validation for referenced assets, local paths, manifests, and documentation links.

Fixed

• Fixed Codex marketplace installation so the complete plugin package is retrieved instead of a sparse marketplace-only checkout.
• Standardized the refreshed logo across plugin manifests.
• Synchronized repository documentation with the release-based changelog workflow.

3. Breaking changes and migration

There are no breaking layout changes in v2.1.0. Existing v2.0.0 installations can update normally.

Codex users affected by the earlier sparse marketplace installation should refresh the marketplace, then remove and reinstall superior-skills once to restore the complete package and plugin icon.

4. Full changelog

v2.0.0...v2.1.0

v2.0.0

Superior Skills v2.0.0

Superior Skills v2.0.0 turns the project into a portable, skills-only plugin that can be installed across Codex, Cursor, Claude Code, and other compatible Agent Plugin hosts. This release also establishes one canonical skill source, strengthens package validation, and expands the installation and update documentation.

Highlights

• Portable multi-agent packaging - Install the same Superior Skills package through Codex, Cursor, or Claude Code using host-specific manifests and marketplace metadata.
• One canonical skill tree - All 10 skills now live under the root skills/ directory, eliminating the duplicated .agents/skills/ mirror.
• Safer releases - Package validation now checks manifest versions, marketplace metadata, skill frontmatter, the fixed Agent Plugins schema URL, and Codex listing constraints.

What's changed

Added

• Added the portable root plugin.json entrypoint using the Agent Plugins specification.
• Added compatibility manifests and marketplace catalogs for Codex, Cursor, and Claude Code.
• Added scripts/validate-plugin.ps1 to validate canonical skills, manifests, marketplace files, and release-version consistency before publishing.
• Added copy-ready installation, update, removal, troubleshooting, and FAQ guidance in the English and Indonesian documentation.
• Added Codex listing metadata, discovery keywords, and the Superior profile image as the plugin logo and composer icon.

Improved

• Consolidated all packaged skills under the root skills/ directory so every supported host reads the same canonical content.
• Updated AGENTS.md, tutorials, principles, and contributor guidance for the portable plugin layout.
• Clarified the difference between plugin installation and the standalone .agents/skills/ fallback.
• Documented how plugin caches and active sessions affect newly installed or updated skills.
• Improved the Codex marketplace subtitle so it satisfies the public-listing length requirement.

Fixed

• Corrected the root manifest schema URL to https://agent-plugins.org/schemas/1.0.0/plugin.schema.json.
• Added validation that prevents the schema URL from being changed accidentally during a package-version bump.
• Added version-consistency checks across VERSION, plugin manifests, and Cursor marketplace metadata.

Removed

• Removed the duplicated .agents/skills/ mirror from the package. Root skills/ is now the only maintained skill source.
• Removed the repository CHANGELOG.md; release history is now published through versioned GitHub releases and tags.

Included skills

• superior-accessibility
• superior-api-security
• superior-comments
• superior-copy
• superior-docs
• superior-lean
• superior-logic
• superior-responsive
• superior-ui
• superior-ui-audit

Compatibility

This release supports:

• Codex and compatible Agent Plugin hosts;
• Cursor through .cursor-plugin/ metadata;
• Claude Code through .claude-plugin/ metadata;
• standalone Agent Skills installation.

Superior Skills remains a skills-only plugin. It does not install an MCP server, lifecycle hook, credential, or external runtime service.

Install

Codex

codex plugin marketplace add KodekaTeam/superior-skills
codex plugin add superior-skills@superior-skills

Cursor

Open Cursor Settings -> Plugins, paste the repository URL below into the plugin search box, and install Superior Skills:

https://github.com/KodekaTeam/superior-skills

Claude Code

Run these commands inside Claude Code:

/plugin marketplace add KodekaTeam/superior-skills
/plugin install superior-skills@superior-skills

See the installation guide for local development and standalone installation options.

Update

Codex

codex plugin marketplace upgrade superior-skills

Claude Code

claude plugin marketplace update superior-skills
claude plugin update superior-skills@superior-skills

For Cursor, update or reinstall Superior Skills from Cursor Settings -> Plugins. Start a new conversation or agent session after updating so the new skill instructions are loaded.

Standalone copies do not update automatically. Replace the installed superior-* directories with the latest directories from the root skills/ folder.

Breaking changes and migration

The canonical skill location has moved from .agents/skills/ to the root skills/ directory.

• Plugin users installing v2.0.0 through Codex, Cursor, or Claude Code do not need to copy skills manually.
• Existing scripts, links, or automation that read this repository's .agents/skills/ directory must be updated to use skills/.
• Existing standalone installations can continue using their host's .agents/skills/ directory, but future updates must copy from this repository's root skills/ directory.
• If a project already has AGENTS.md or CLAUDE.md, merge the relevant Superior instructions instead of replacing project-specific rules.

Verification

• Validated 10 canonical skills.
• Validated 4 plugin manifests.
• Validated 3 marketplace catalogs.
• Confirmed version 2.0.0 across all versioned plugin configurations.
• Confirmed the portable manifest retains the Agent Plugins 1.0.0 schema URL.

Important

The package version changes with each Superior release, but the root plugin.json $schema URL remains https://agent-plugins.org/schemas/1.0.0/plugin.schema.json. The schema version and package version are independent.

Contributors

Thanks to everyone who reported issues, tested installation flows, proposed improvements, or contributed to this release.

Full changelog: v1.5.0...v2.0.0

v1.5.0

Superior Skills v1.5.0

Superior Skills v1.5.0 expands the original engineering skill set in three practical directions: defensive REST API security, automatic implementation-history recording, and deeper UI composition and motion guidance. It also adds the community and governance files needed for the project to grow as an open-source repository.

Highlights

• REST API security workflow - A dedicated skill now covers authorization boundaries, validation, rate limiting, abuse controls, resource limits, SSRF defenses, safe telemetry, and security verification.
• Documentation continuity by default - Material implementation work can now produce focused history entries under feature-specific docs/implementation-timeline/ directories unless the user explicitly opts out.
• More expressive interface guidance - New references cover composition, component craft, motion choreography, rendering performance, and responsive behavior without forcing one visual style.

What's changed

Added

• Added superior-api-security with focused references for API security controls, rate limiting, abuse prevention, and verification.
• Added automatic change-recording guidance to superior-docs, including feature-based history folders and specific dated filenames.
• Added UI references for expressive composition, component construction, motion behavior, and GPU-conscious rendering.
• Added English and Indonesian tutorials for the API security and documentation workflows.
• Added CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, and the MIT LICENSE.
• Added repository versioning files and a .gitignore for local artifacts and generated documentation.

Improved

• Updated skill routing so application-logic tasks can hand off to the API security workflow when the change crosses a trust boundary.
• Improved superior-docs guidance for documentation maps, handoffs, and durable implementation history.
• Expanded the skill-combination tutorials to show when security and documentation skills should participate in the same task.
• Refined the bilingual README and tutorials to describe the complete 10-skill collection.

Included skills

• superior-accessibility
• superior-api-security
• superior-comments
• superior-copy
• superior-docs
• superior-lean
• superior-logic
• superior-responsive
• superior-ui
• superior-ui-audit

Compatibility

Version 1.5.0 uses the standalone Agent Skills layout:

.agents/
`-- skills/
    `-- superior-*/

It is designed for Codex-compatible skill discovery at repository or user scope. This version predates the portable plugin manifests introduced in Superior Skills v2.0.0.

Install

Copy AGENTS.md and the complete .agents/ directory into the target repository root:

project/
|-- AGENTS.md
`-- .agents/
    `-- skills/
        `-- superior-*/

If the project already has an AGENTS.md, merge the Superior baseline into it instead of replacing project-specific commands, architecture notes, validation steps, or domain rules.

For a user-scoped installation, copy each superior-* directory to:

$HOME/.agents/skills/

Update from v1.0.0

1. Replace the previously installed superior-* directories with the directories from the v1.5.0 .agents/skills/ folder.
2. Add the new superior-api-security directory if skills are maintained individually.
3. Merge the updated AGENTS.md guidance without deleting project-specific instructions.
4. Start a new agent session, then invoke a skill explicitly, such as $superior-api-security, to confirm discovery.

Behavior and migration notes

There is no required directory-layout migration from v1.0.0; both releases use .agents/skills/ as their canonical skill location.

The main behavioral change is documentation continuity: for material and verified implementation work, superior-docs now records a focused change entry by default when appropriate. Users can explicitly request that no documentation be created for a task, and that instruction takes precedence.

Verification

• Confirmed all 10 skill directories contain an uppercase SKILL.md entrypoint.
• Confirmed the API security skill includes dedicated control, rate-limiting, and verification references.
• Confirmed automatic documentation guidance is connected to the documentation map and handoff workflow.
• Confirmed English and Indonesian tutorials cover the newly added workflows.

Contributors

Thanks to everyone who reviewed the workflows, tested the skills, reported gaps, or contributed improvements to this release.

Full changelog: v1.0.0...v1.5.0

v1.0.0

v1.0.0: Superior Skills

chore: initialize repository