@pithos-kit/skills

SRS prompting and test-driven development guidance for Pi.

Packages

Package details

extensionskillprompt

Install @pithos-kit/skills from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@pithos-kit/skills
Package
@pithos-kit/skills
Version
0.5.0
Published
Aug 18, 2026
Downloads
263/mo · 195/wk
Author
anton-kochev
License
MIT
Types
extension, skill, prompt
Size
33.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/help.ts"
  ],
  "prompts": [
    "./prompts"
  ],
  "skills": [
    "./skills"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@pithos-kit/skills

npm version

SRS prompting and test-driven development guidance for Pi.

Use /srs to create an ISO/IEC/IEEE 29148:2018 Software Requirements Specification with EARS requirements, explicit approval gating, and a traceability matrix.

Use the tdd skill when you want the agent to build or change non-trivial logic test-first with the red-green-refactor loop.

Plan mode is now published independently as @pithos-kit/plan. When adopting the split, update Skills to 0.5.0 or later and install the Plan package at the same time; combining it with Skills 0.4.0 or earlier creates duplicate /plan handlers.

Install

pi install npm:@pithos-kit/skills

For local development from this repository:

pi install -l ./pithos.skills

Pithos .pithos config

pi:
  extensions:
    "@pithos-kit/skills": "npm:0.5.0"

Usage

Invoke the SRS prompt directly:

/srs <product or change description>
/srs --help

The command accepts --help or -h before prompt expansion, so asking for help does not start an agent turn. The TDD workflow is packaged as a skill that Pi can load proactively for matching requests.

Force the TDD skill with:

/skill:tdd <your task>
/skill:tdd --help

The help invocation is intercepted before the skill is expanded.

Changelog

0.5.0

  • Move Plan mode, controlled plan creation, and the Plan theme to @pithos-kit/plan.
  • Keep /srs and /skill:tdd help handling in Skills without activating their prompt or skill.

0.4.0

  • Move /commit and the conventional-commit skill to @pithos-kit/atlas.
  • Use the controlled create_plan confirmation as the sole final approval gate once planning decisions are resolved.

0.3.2

  • Create generated plans atomically through a dedicated controlled tool so late path collisions cannot overwrite existing files.
  • Clarify the Plan mode enforcement boundary and behavior without an interactive UI.

0.3.1

  • Enforce read-only Plan mode across built-in, custom, and user-shell tools, with fail-closed activation and branch-scoped state restoration.
  • Require interactive approval for the exact generated plan write; continuing stays in Plan mode, while a successful approved write exits and authorizes implementation.

0.3.0

  • Ask whether to create the generated plan file when exiting an active /plan session.
  • Add an automatic temporary minimal plan theme and replace the standard footer with a subtly fading ● planning indicator while /plan is active.
  • Save plans under .pi/plans/ with unique, timestamp-prefixed readable names instead of overwriting a root PLAN.md or adding numeric suffixes.
  • Fix cancelled /plan sessions continuing to influence later model turns through stale prompt history.

0.2.0

  • /commit: infer and stage relevant files when commit intent is clear, while preserving staged-only commits and avoiding local artifacts.

0.1.3

  • Fix /plan prompt command discovery by quoting its YAML frontmatter description.

0.1.2

  • Add /srs prompt command for ISO/IEC/IEEE 29148:2018 SRS generation with EARS requirements and traceability.

0.1.1

  • /commit: reconcile the subject-mood rule with the problem-framed examples (declarative when stating a problem, imperative when describing value), default to subject-only bodies, and fix an over-length breaking-change example.

0.1.0

  • Initial release: /plan and /commit prompt commands plus the tdd skill.