YHTTP SSR Codex Skill

A Codex skill for building, extending, diagnosing, and reviewing server-side-rendered YHTTP applications.

The skill guides Codex through an existing project's composition, routing, Mako templates, localization, assets, authentication, persistence, and tests. It favors the project's installed YHTTP extensions and established conventions over introducing parallel frameworks or infrastructure.

What it covers

• YHTTP application composition and route or model registration
• Server-rendered pages, shared Mako layouts, forms, and metadata
• Localized routes, translated content, and LTR/RTL behavior
• Alpine.js progressive enhancement and Vite-managed assets
• Authentication-aware pages, authorization, and persistence boundaries
• bddrest and project-native page tests
• Safe worktree inspection, verification, and change reporting

Install

Ask Codex to install the skill from this repository:

$skill-installer install https://github.com/yhttp/yhttp-ssr-codex-skill

Or use the included Makefile. make install copies the skill files into the Codex skills directory. make uninstall removes that installed copy only; it does not remove this source checkout.

The default destination is $CODEX_HOME/skills when CODEX_HOME is set, otherwise ~/.codex/skills:

make install

To remove it later:

make uninstall

Override the destination when using a different skills directory:

make install SKILLS_DIR=/path/to/skills
make uninstall SKILLS_DIR=/path/to/skills

Alternatively, clone it into your user skills directory:

mkdir -p ~/.codex/skills
git clone https://github.com/yhttp/yhttp-ssr-codex-skill.git ~/.codex/skills/yhttp-ssr

Codex usually detects new skills automatically. Restart Codex if the skill does not appear in /skills.

Use

Mention the skill explicitly in a Codex prompt:

$yhttp-ssr add a localized contact page with English and Arabic routes.

$yhttp-ssr diagnose why this Mako page is not reachable and add a regression test.

$yhttp-ssr review the authentication, localization, and asset handling in this SSR feature.

Codex can also select the skill automatically when a request matches its scope.

Repository contents

.
├── SKILL.md                    # Core workflow and implementation guidance
├── agents/openai.yaml          # Skill display metadata and default prompt
└── LICENSE

Scope

This self-contained skill is intended for work in an existing YHTTP codebase. It has no application-project or auxiliary-reference dependency: Codex first inspects the target repository, verifies the installed framework and extension APIs, and follows the nearest complete feature before making changes. It does not install YHTTP, replace project-specific instructions, or prescribe a new application architecture.

Every commit made while using this skill must pass the target project's full coverage suite at exactly 100%. Do not use exclusions, pragmas, lowered thresholds, or weakened assertions to obtain that result.

License

Released under the MIT License.