port-spec

Generate engineering port artifacts for migrating frontend features to React.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Scripsteam/scrips-stack --skill port-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: port-spec
Source: https://github.com/Scripsteam/scrips-stack/tree/main/port-spec
Command: npx skills add https://github.com/Scripsteam/scrips-stack --skill port-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Port-spec solves the challenge of documenting and orchestrating engineering porting work when moving a live feature from one frontend stack to another, ensuring all stakeholders have a consistent, testable contract.

Core Features & Use Cases

  • Structured artifact generation: flow.md, state-machine.md, api-contract.md, gaps.md, and a Stage 03 packet.
  • Cross-team provenance: traces inputs from Stage 01 sources and live FE audit to keep missable gaps visible.
  • Reusable port blueprint: defines port scope, validation, and sequencing to guide implementation across platforms.

Quick Start

Execute port-spec as part of the feature porting workflow to generate engineering-port artifacts and capture cross-team inputs.

Frequently Asked Questions about port-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I document engineering specs for porting a live feature to React?

To document feature porting specs, you need structured artifacts like flow diagrams, state machines, and API contracts. Port-spec generates these engineering files by integrating design, backend, Confluence, and live frontend audit inputs to ensure a testable cross-team migration contract.

Can I use a structured port specification to migrate a feature from Flutter to React?

Yes, a structured port specification applies to migrating live features from Flutter, Razor, or Vue to React. It defines the port scope, validation, and sequencing required to guide implementation across different frontend technologies while tracing source provenance.

What artifacts do I need to orchestrate a frontend feature migration across platforms?

Orchestrating a frontend feature migration requires flow.md, state-machine.md, api-contract.md, and gaps.md. These engineering flow artifacts capture cross-team inputs and keep missable gaps visible, culminating in a Stage 03 review packet for stakeholder alignment.

Does port spec generation work with Confluence and live frontend audit inputs?

Yes, port spec generation integrates Confluence documentation, backend data, design inputs, and live frontend audit findings. It traces these Stage 01 sources to ensure all stakeholders have a consistent, testable contract during the feature migration process.

Best way to capture missable gaps when porting live features to a new frontend stack?

The best way to capture missable gaps is to generate a dedicated gaps.md artifact using a structured port blueprint. By tracing inputs from Stage 01 sources and live frontend audits, it keeps cross-team provenance visible throughout the migration.

Why do I need an engineering port blueprint for frontend migrations?

An engineering port blueprint is needed to define port scope, validation, and sequencing for live feature migrations. It ensures all stakeholders have a consistent, testable contract, preventing undocumented behavior when moving features between frontend technologies.