New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Update Spec

by yuriolive in yuriolive/PortPS5

Keep PortPS5 docs (PRD, ROADMAP, docs/spec/.md) in sync with a code or design change and run the docs acceptance checks.

GPL-2.0Auto-check passedProduct & Project Management

Install Update Spec

skills CLI
$ npx skills add yuriolive/PortPS5 --skill update-spec -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install yuriolive/PortPS5 update-spec --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/yuriolive/PortPS5.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/update-spec .claude/skills/update-spec && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
update-spec
GitHub stars
174
Token cost
~428 tokens
SKILL.md length
190 words
Files
1
Skills in repo
6
Repo updated
First seen
Licence
GPL-2.0

At a glance

Keep PortPS5 docs (PRD, ROADMAP, docs/spec/.md) in sync with a code or design change and run the docs acceptance checks.

  • Works in 5 steps: Find the spec(s) for the subsystem using… → Edit only the sections the change affects → Cross-doc consistency → …
  • Changing subsystem behaviour
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Tasks that involve PRD writing

What it does

Update Spec is an agent skill from yuriolive/PortPS5. Keep PortPS5 docs (PRD, ROADMAP, docs/spec/.md) in sync with a code or design change and run the docs acceptance checks. Use when changing subsystem behaviour, interfaces or decisions, or when editing docs.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Product & Project Management, covering PRD writing. The repository describes itself as: Converts decrypted PS5 game dumps into native Windows executables via binary relinking, replacement system libraries, and Vulkan. No CPU emulation. The licence is GPL-2.0.

When your agent uses it

  • Changing subsystem behaviour
  • Tasks that involve PRD writing

Example prompts

  • “/update-spec”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Find the spec(s) for the subsystem using the table in docs/spec/README.md.
  2. Edit only the sections the change affects
  3. Cross-doc consistency
  4. Hardware wording: only the generic reference tier. Check with grep -rniE '(RTX|RX) ?[0-9]{4}|Ryzen [0-9]|Core i[3579]|my PC|your PC' docs…
  5. Structure check: every docs/spec/.md except README.md and verification.md contains the headings Scope, Current state, Decision, Target…

What it can do on your machine

Read from SKILL.md and the folder at commit aa7d6da. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Update Spec loads about 428 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 190 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~55
When it runs · the whole SKILL.md, loaded when a task matches
~428

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from yuriolive/PortPS5 at commit aa7d6da, republished under its GPL-2.0 licence (© yuriolive). 190 words, ~428 tokens.

Download SKILL.mdSave it as .claude/skills/update-spec/SKILL.md (or your agent's skills folder).
name
update-spec
description
Keep PortPS5 docs (PRD, ROADMAP, docs/spec/*.md) in sync with a code or design change and run the docs acceptance checks. Use when changing subsystem behaviour, interfaces or decisions, or when editing docs.

Update a spec

  1. Find the spec(s) for the subsystem using the table in docs/spec/README.md.
  2. Edit only the sections the change affects:
    • Current state: what the code does now, with path:line refs checked against the tree.
    • Decision, if it changed. A changed decision needs maintainer approval, so say so in the PR.
    • Target design, Interfaces, Failure modes, Tests.
    • Milestones: keep them consistent with docs/ROADMAP.md.
  3. Cross-doc consistency:
    • If a milestone's scope moves or finishes, update docs/ROADMAP.md (and mark completed items with - [x]), including its traceability table.
    • If a 1.0 requirement changes, update docs/PRD.md.
    • Keep task checkboxes (- [ ] / - [x]) in docs/spec/*.md synchronized with delivered scope.
  4. Hardware wording: only the generic reference tier. Check with grep -rniE '(RTX|RX) ?[0-9]{4}|Ryzen [0-9]|Core i[3579]|my PC|your PC' docs, which must print nothing.
  5. Structure check: every docs/spec/<subsystem>.md except README.md and verification.md contains the headings Scope, Current state, Decision, Target design, Interfaces, Failure modes, Tests, Milestones, Open questions: for f in docs/spec/*.md; do case $f in *README.md|*verification.md) continue;; esac; for h in Scope 'Current state' Decision 'Target design' Interfaces 'Failure modes' Tests Milestones 'Open questions'; do grep -q "^## $h" "$f" || echo "$f missing $h"; done; done

© yuriolive, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/update-spec of yuriolive/PortPS5.

Open the folder on GitHubat commit aa7d6da

Compare with similar skills

Update Spec next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Update Spec compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Update Spec this skillyuriolive/PortPS5174—~428Automated safety check: PassGPL-2.0
CCPM Project Managementautomazeio/ccpm8.4k—~1.1kAutomated safety check: PassMIT
Ralph Tui Create Beadssubsy/ralph-tui2.5k1 repos~2.6kAutomated safety check: PassMIT
Trellis Brainstormanjiemo/SunnyBeach1787 repos~4kAutomated safety check: PassApache-2.0
Adversarial Speczscole/adversarial-spec5561 repos~8.3kAutomated safety check: NotesMIT
Ralph Tui Create Beads Rustsubsy/ralph-tui2.5k1 repos~2.8kAutomated safety check: PassMIT

Similar skills

  • CCPM Project Management

    automazeio/ccpm

    Runs a spec-driven workflow from PRD to epic to GitHub issues to parallel agents, with status, standup and blocked-work reports from bundled scripts.

    8.4k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed

  • Ralph Tui Create Beads

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution. An agent skill from subsy/ralph-tui.

    2.5k GitHub starsUsed in 1 repo~2.6k tokens
    Product & Project ManagementAuto-check passed

  • Trellis Brainstorm

    anjiemo/SunnyBeach

    Guides collaborative requirements discovery before implementation.

    178 GitHub starsUsed in 7 repos~4k tokens
    Product & Project ManagementAuto-check passed

  • Adversarial Spec

    zscole/adversarial-spec

    Iteratively refine a product spec by debating with multiple LLMs (GPT, Gemini, Grok, etc.) until all models agree.

    556 GitHub starsUsed in 1 repo~8.3k tokens
    Product & Project ManagementAuto-check: notes

  • Ralph Tui Create Beads Rust

    subsy/ralph-tui

    Convert PRDs to beads for ralph-tui execution using beads-rust (br CLI).

    2.5k GitHub starsUsed in 1 repo~2.8k tokens
    Product & Project ManagementAuto-check passed

  • Ouroboros PM Interview

    Q00/ouroboros

    Runs a guided product-manager interview that classifies each question automatically and produces a Product Requirements Document.

    6.2k GitHub starsUsed in 1 repo~5.7k tokens
    Product & Project ManagementAuto-check passed

More from yuriolive/PortPS5

  • Start Task

    yuriolive/PortPS5

    Standard procedure to start a new task in PortPS5. An agent skill from yuriolive/PortPS5.

    174 GitHub stars~629 tokensUpdated 6 days ago
    Auto-check passed

  • Build And Test

    yuriolive/PortPS5

    Configure, build and test PortPS5 with the pinned MinGW-w64 GCC 15.2 toolchain and ctest.

    174 GitHub stars~435 tokensUpdated 6 days ago
    Auto-check passed

  • Implement Prx Function

    yuriolive/PortPS5

    Implement or fix a PS5 system-library (prx) function in PortPS5 (NID export, System V ABI, return codes, test).

    174 GitHub stars~361 tokensUpdated 6 days ago
    Auto-check passed

  • Milestone Seed

    yuriolive/PortPS5

    Turn a PortPS5 ROADMAP milestone into an executable work plan (an Ouroboros seed YAML under seeds/, or a task plan for tools without Ouroboros).

    174 GitHub stars~315 tokensUpdated 6 days ago
    Auto-check passed

  • Compat Result

    yuriolive/PortPS5

    Record a locally-run PortPS5 title test (regression or full run) as a results JSON for the compatibility list, without leaking game data.

    174 GitHub stars~317 tokensUpdated 6 days ago
    Auto-check passed

Categories

Questions about Update Spec

What does Update Spec do?

Keep PortPS5 docs (PRD, ROADMAP, docs/spec/.md) in sync with a code or design change and run the docs acceptance checks. Update Spec is an agent skill from yuriolive/PortPS5.md) in sync with a code or design change and run the docs acceptance checks.

When should I use Update Spec?

Update Spec fits situations like: changing subsystem behaviour; tasks that involve PRD writing.

How do I install Update Spec in Claude Code?

Run `npx skills add yuriolive/PortPS5 --skill update-spec -a claude-code`. Or copy the skill folder (.agents/skills/update-spec in yuriolive/PortPS5) into .claude/skills/update-spec in your project. Claude Code loads it when a task matches its description.

How do I install Update Spec in Codex?

Run `npx skills add yuriolive/PortPS5 --skill update-spec -a codex`. Or copy the skill folder (.agents/skills/update-spec in yuriolive/PortPS5) into .agents/skills/update-spec in your project. Codex loads it when a task matches its description.

Can I use Update Spec in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add yuriolive/PortPS5 --skill update-spec -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/update-spec, .gemini/skills/update-spec, .github/skills/update-spec and .opencode/skills/update-spec in your project.

What does Update Spec need to run?

SKILL.md names no scripts, command-line tools or credentials: Update Spec is instructions for the agent only.

Does Update Spec access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Update Spec safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Update Spec use?

Update Spec is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Update Spec use?

About 428 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Update Spec?

Skills that share tags, products or a category with Update Spec: CCPM Project Management (automazeio/ccpm, 8.4k stars), Ralph Tui Create Beads (subsy/ralph-tui, 2.5k stars), Trellis Brainstorm (anjiemo/SunnyBeach, 178 stars) and Adversarial Spec (zscole/adversarial-spec, 556 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Update Spec?

yuriolive (a GitHub user) maintains it in yuriolive/PortPS5, which has 174 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on October 1, 2026.

Source: yuriolive/PortPS5 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.