psi — community dot-agent, community, ide skills, Claude Code, Cursor, Windsurf

v1.0.0

About this Skill

Ideal for Software Engineer Agents requiring a structured approach to planning, specifying, and implementing changes with up-to-date documentation. Plan-spec-implement workflow for structured development. Only use when explicitly directed by user or when mentioned in project AGENTS.md file. Generates ephemeral plans in ~/.dot-agent/, applies spec

siviter-xyz siviter-xyz
[0]
[0]
Updated: 3/12/2026

Killer-Skills Review

Decision support comes first. Repository text comes second.

Reference-Only Page Review Score: 7/11

This page remains useful for operators, but Killer-Skills treats it as reference material instead of a primary organic landing page.

Original recommendation layer Concrete use-case guidance Explicit limitations and caution Locale and body language aligned
Review Score
7/11
Quality Score
41
Canonical Locale
en
Detected Body Locale
en

Ideal for Software Engineer Agents requiring a structured approach to planning, specifying, and implementing changes with up-to-date documentation. Plan-spec-implement workflow for structured development. Only use when explicitly directed by user or when mentioned in project AGENTS.md file. Generates ephemeral plans in ~/.dot-agent/, applies spec

Core Value

Empowers agents to follow a documentation-first approach using the Plan Spec Implement workflow, ensuring seamless project management through phases like Plan, Spec, and Implement, all while maintaining current documentation.

Ideal Agent Persona

Ideal for Software Engineer Agents requiring a structured approach to planning, specifying, and implementing changes with up-to-date documentation.

Capabilities Granted for psi

Automating workflow planning with explicit user direction
Generating project specifications with mention in AGENTS.md files
Implementing changes with real-time documentation updates

! Prerequisites & Limits

  • Requires explicit user direction or mention in project AGENTS.md file
  • Not intended for automatic use
  • Must adhere to the Plan Spec Implement workflow

Why this page is reference-only

  • - The underlying skill quality score is below the review floor.

Source Boundary

The section below is supporting source material from the upstream repository. Use the Killer-Skills review above as the primary decision layer.

Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is psi?

Ideal for Software Engineer Agents requiring a structured approach to planning, specifying, and implementing changes with up-to-date documentation. Plan-spec-implement workflow for structured development. Only use when explicitly directed by user or when mentioned in project AGENTS.md file. Generates ephemeral plans in ~/.dot-agent/, applies spec

How do I install psi?

Run the command: npx killer-skills add siviter-xyz/dot-agent/psi. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for psi?

Key use cases include: Automating workflow planning with explicit user direction, Generating project specifications with mention in AGENTS.md files, Implementing changes with real-time documentation updates.

Which IDEs are compatible with psi?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for psi?

Requires explicit user direction or mention in project AGENTS.md file. Not intended for automatic use. Must adhere to the Plan Spec Implement workflow.

How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add siviter-xyz/dot-agent/psi. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use psi immediately in the current project.

! Reference-Only Mode

This page remains useful for installation and reference, but Killer-Skills no longer treats it as a primary indexable landing page. Read the review above before relying on the upstream repository instructions.

Imported Repository Instructions

The section below is supporting source material from the upstream repository. Use the Killer-Skills review above as the primary decision layer.

Supporting Evidence

psi

Install psi, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly
Imported Repository Instructions
The section below is supporting source material from the upstream repository. Use the Killer-Skills review above as the primary decision layer.
Supporting Evidence

PSI - Plan Spec Implement

Structured workflow for planning, specifying, and implementing changes with documentation-first approach.

When to Use

Only use when:

  • Explicitly directed by the user
  • Mentioned in project AGENTS.md file

Do not use automatically - this is an opt-in workflow, not a default.

Core Workflow

Plan → Spec → Implement

Phases are independent - you can start with any phase, but all must ensure documentation stays up-to-date.

Key Principles

  1. Ephemeral planning - Plans stored in ~/.dot-agent/ (not committed)
  2. Documentation-first - Specs applied to project docs/READMEs/AGENTS.md
  3. Test-first implementation - Tests for docs/user journeys before code
  4. Design/review embedded - Design and review integrated into Plan/Spec phases
  5. Phase independence - Each phase can work standalone, all update docs

Phase Overview

Plan Phase

  • Generates detailed plans in ~/.dot-agent/repo/YYYY-MM-work-name.plan.md
  • Research stored in ~/.dot-agent/working-dir/repo/YYYY-MM-work-name.research.md
  • Embeds design considerations
  • Includes review before proceeding

Spec Phase

  • Generates specs for: API schemas, interfaces, DTOs, database models, config, env vars, architecture, user journeys, package structure, tech choices
  • Embeds design considerations
  • Reviews specs before applying
  • Applies to: docs/, README.md files, AGENTS.md files

Implement Phase

  • Test-first: tests for docs/user journeys before code
  • CI verification: verify types, tests, lint pass before committing
  • Atomic commits: group related changes with tests
  • Updates docs, README.md, AGENTS.md as code evolves
  • Can work independently if specs exist in docs

Research Management

Detects phrases like:

  • "looking at your research" → Loads research file
  • "refine your research" → Updates research file, narrows focus

Documentation Structure

  • README.md: Aim for < 1000 lines (not hard rule), can be longer if needed
  • AGENTS.md: < 200 lines, inline at root/packages/modules/code level
  • docs/: Architecture, roadmap, tech-choices, setup/, user-journeys/, design/

References

For detailed protocols, see:

  • references/plan-phase.md - Plan generation with embedded design/review
  • references/spec-phase.md - Spec generation and application
  • references/implement-phase.md - Test-first implementation
  • references/review-protocol.md - Reviewing plans/specs/design
  • references/research-management.md - Research file handling
  • references/docs-structure.md - Documentation organization rules
  • references/file-paths.md - Storage paths and conventions

Related Skills

Looking for an alternative to psi or another community skill for your workflow? Explore these related open-source skills.

View All

openclaw-release-maintainer

Logo of openclaw
openclaw

Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞

333.8k
0
AI

widget-generator

Logo of f
f

Generate customizable widget plugins for the prompts.chat feed system

149.6k
0
AI

flags

Logo of vercel
vercel

The React Framework

138.4k
0
Browser

pr-review

Logo of pytorch
pytorch

Tensors and Dynamic neural networks in Python with strong GPU acceleration

98.6k
0
Developer