markskill

Engineering judgment for code and product work.

markskill helps AI agents and assistants understand the problem, choose the right scope of change, and show what the evidence supports.

npx skills add thedevmark/markskill -g Read the skill

What it covers

Five parts, in the order a task uses them.

Project record

Read the repository's product, design, and context files before searching the code. Write back the durable facts a task establishes, so the next session starts from evidence.

Project record

Scope judgment

Start with the user's goal and the observed behavior. Keep sound structure; repair, restructure, or replace what prevents the required result.

Shared rules

Code

Trace invariants, callers, state, and data before changing the owner. Preserve validation, authorization, recovery, and useful regression evidence.

Engineering judgment

Product surfaces

Work from real content, established components, and the states people will encounter. Change layout, interaction, and copy where they get in the way.

DesignCopyVisualsAssets

Verification

Separate source inspection, tests, rendered behavior, and production checks. Claim only what ran, and hand off long or risky work with a brief the reviewer can check.

Evidence and testingExecution and review