Engineering Skills

A small set of AI coding-agent skills for taking work from an idea to a verified pull request. Plan around existing code, implement in manageable increments, and review both correctness and structure.

Simple designs. Explicit scope. Evidence before completion.

Quick start

Install in Codex:

codex plugin marketplace add igorrendulic/engineering-skills --ref master && \
  codex plugin add engineering-skills@engineering-skills

Start a new Codex session after installing.

Invoke a workflow or ask for help:

$engineering-skills:help
$engineering-skills:help plan
$engineering-skills:init Initialize this project's AGENTS.md
$engineering-skills:plan Add password reset
$engineering-skills:implementation Implement the password-reset plan
$engineering-skills:pr-review Review the password-reset changes
$engineering-skills:github-pr Create a PR for these changes

Help explains workflows, inputs, outputs, and examples without executing them. The workflow examples are agent prompts, not shell commands. The package preserves shared references and sibling skills.

plan includes structural design review. implementation includes structural review at substantial checkpoints and independent pr-review when required, with repairs and re-review. The example makes pr-review explicit before PR creation; an existing review can be reused while its scope, snapshot, and evidence still apply.

The SDLC

flowchart TD
    A["init: establish project instructions"] --> B

    subgraph Planning["plan workflow"]
        B["Define goal, scope, and design"] --> C["structural-review: assess the design"]
        C --> D["Resolve findings; define tasks and verification"]
        D --> P{"Plan ready?"}
        P -->|Revise within scope| B
        P -->|Blocked| Q["Report blockers; plan remains not ready"]
    end

    P -->|Yes, implementation authorized| E

    subgraph Implementation["implementation workflow"]
        E["Build or repair and verify increments"] --> F["structural-review: at substantial checkpoints"]
        F --> S{"Required structural review complete, with no unresolved High or Medium findings?"}
        S -->|Yes or not required| G["Verify the complete outcome"]
        S -->|No| R
        G --> H{"Independent review required?"}
        H -->|Yes| I["pr-review: fresh-context correctness review"]
        I --> J{"No blocking findings and required verification satisfied?"}
        H -->|No| J
        J -->|No| R{"Can resolve within scope and remaining repair limit?"}
        R -->|Yes| E
        R -->|No: limit, no progress, or blocked| X["Preserve work; report unresolved findings or evidence gaps"]
        J -->|Yes| V["Retain verified implementation; report results"]
    end

    V -->|PR delivery authorized| K["github-pr: create or update the PR"]

Start at the stage that fits the work; small, obvious changes can go straight to implementation. Review steps inside each workflow are invoked by that workflow. Independent review is required for substantial behavior changes, changes affecting security, data integrity, or shared/public contracts, and whenever the user or repository requires it. Explicit review waivers must be disclosed. The review-and-fix loop defaults to at most three repair rounds, each including a fresh follow-up review; it stops earlier when progress or authorization is blocked. Missing required evidence prevents completion. Publishing, merging, and deployment follow the user's authorization.

Workflows

Plans default to tasks/<feature-slug>/plan.md and todo.md, while respecting existing project conventions. See the shared plan lifecycle and code quality principles.

Contributing

Add workflows under skills/<name>/SKILL.md and register them in the root dispatcher. Keep instructions focused, reuse shared references, and include verification appropriate to the change.

The dispatcher table is also the help catalog. Keep skill names short; the plugin manifest owns the namespace. See local checks for package loading, installer regression tests, and skill evaluation. Bump the manifest version when releasing changed plugin contents so installed versions remain identifiable.