Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
othmanadi avatar

Apex Replatform

  • 4 installs
  • 2 repo stars
  • Updated March 14, 2026
  • othmanadi/apex

Implement a feature in a new architecture from a specification document, mapping spec concepts to target patterns and self-validating.

About

Implements a feature in a target architecture from a specification document, without needing the original source. A developer uses it to rebuild a decomposed feature in a new framework using the spec as the source of truth.

  • Maps spec concepts to target architecture patterns with user confirmation
  • Self-correcting loop runs lint, typecheck, tests, build until clean

Apex Replatform by the numbers

  • 4 all-time installs (skills.sh)
  • +1 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #3,711 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/othmanadi/apex --skill apex-replatform

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs4
repo stars2
Last updatedMarch 14, 2026
Repositoryothmanadi/apex

What it does

Implement a feature in a new architecture from a specification document, mapping spec concepts to target patterns and self-validating.

Files

SKILL.mdMarkdownGitHub ↗

APEX Replatform

Take a feature specification (from apex-decompose or manually written) and implement it in a target architecture. This is the "mapping problem" — translating what exists into what should exist.

When to Use

Use this skill after you have a specification document describing the feature's behavior. You should NOT need access to the original source code. The spec is your single source of truth.

Workflow

Replatforming a feature involves these steps:

1. Load and understand the specification 2. Map the spec to the target architecture 3. Implement the feature 4. Wire up self-correcting feedback loops 5. Validate against the spec's acceptance criteria

Step 1: Load the Specification

Read the spec file:

Read specs/{feature-name}.md

Identify all [VERIFY] tags. Ask the user to resolve any ambiguities before proceeding. Do not guess on verified items.

Step 2: Map to Target Architecture

Create a mapping document that translates spec concepts to target patterns:

Spec ConceptTarget Implementation
Database write to users tablePrisma user.create() call
REST endpoint /api/v1/itemsNext.js API route app/api/items/route.ts
Event emission item.createdEventEmitter / message queue publish

Ask the user to confirm the mapping before writing code. This is the architectural decision point.

Step 3: Implement the Feature

Write code following these rules:

1. One file at a time. Complete each file before moving to the next. 2. Match the spec exactly. Every input, output, and side effect in the spec must be implemented. 3. Preserve edge cases. If the spec says "returns 400 when empty," implement that exact behavior. 4. Add inline comments referencing the spec: // Spec: Edge Case #3 — concurrent request handling

Step 4: Self-Correcting Feedback Loop

After writing code, run the validation chain. Detect OS and use the appropriate script:

Linux/Mac:

bash "${CLAUDE_SKILL_DIR}/scripts/validate.sh" <target-dir>

Windows:

powershell -File "${CLAUDE_SKILL_DIR}/scripts/validate.ps1" <target-dir>

The validation script runs in order: linter, type checker, tests, build. If any step fails, read the error output, fix the issue, and re-run. Repeat until all four pass. Do NOT ask the user for help until you have attempted at least 3 fix cycles.

Step 5: Validate Against Spec

Walk through every section of the spec and confirm implementation coverage:

Spec SectionStatusNotes
InputsPASS/FAILAll parameters handled
OutputsPASS/FAILResponse shape matches
Side EffectsPASS/FAILAll mutations implemented
Edge CasesPASS/FAILEach case has a code path
DependenciesPASS/FAILAll packages installed

Create a draft PR with this checklist in the description.

Output

A working implementation in the target architecture that matches the specification, with a passing validation chain and a draft PR ready for human review.

Example PR body:

## apex: Implement user-authentication from spec

### Spec Coverage
| Section | Status | Notes |
|---------|--------|-------|
| Inputs | ✅ PASS | All parameters handled |
| Outputs | ✅ PASS | JWT + cookie response |
| Side Effects | ✅ PASS | Session + event implemented |
| Edge Cases | ✅ PASS | 401/403 paths verified |

### Validation Results
- Lint: ✅ PASS
- Types: ✅ PASS
- Tests: ✅ PASS (12 new, 0 failing)
- Build: ✅ PASS

### Files Changed
- `src/auth/login.ts` (new)
- `src/auth/session.ts` (new)
- `src/events/user.ts` (modified)

Related skills

Backend & APIsbackendintegrations

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.