Superpower with Files

Unified AI workflow with persistent memory, TDD execution, and 15 productivity skills. Use when starting any coding project or when you need planning, execut...

Security Scan

The skill's code and runtime instructions are consistent with its stated purpose (a local, file-backed planning + TDD workflow); it reads/writes local project files and some IDE session storage but does not request external credentials or perform unexpected network installs.

Purpose & Capability

Name/description promise a local, file-backed planning + TDD workflow. The repo contains templates, scripts, and skill manifests that create and manage task_plan.md, findings.md, progress.md and provide helper hooks — all expected for that purpose. No required env vars or external services are declared, which matches a local workflow.

Instruction Scope

Runtime instructions and hooks routinely read and write project files and call git/powershell/python utilities. session-catchup.py attempts to read local IDE session stores (e.g. ~/.claude, OpenCode locations) to recover conversation history; hooks also read task_plan.md before tool use. This behavior is coherent with 'persistent memory' recovery, but it means the skill will ingest local session data and git history into agent context — a sensitive but expected action for this skill.

Install Mechanism

There is no install spec (instruction-only skill with shipped scripts). No remote downloads, package installs, or extract-from-URL actions are present in the provided files. Files will be copied into the agent's skill folder on install, which is standard for skills of this type.

Credentials

The skill does not require secrets or service credentials. It references environment variables (e.g. OPENCODE_DATA_DIR, CLAUDE_PLUGIN_ROOT) to locate IDE-specific storage but does not declare required credentials. This is proportionate to its goal of locating local IDE session storage and plugin templates.

Persistence & Privilege

The skill is not marked always:true. It contains skill hooks (PreToolUse/PostToolUse/Stop) and can be invoked autonomously by default (platform standard). It does not attempt to modify other skills' configs or request system-wide privileges beyond reading/writing project files and reading IDE session storage.

Assessment

This skill is internally consistent for a local, file-based planning and TDD workflow, but it will read and write files in your project (creating a .superpower-with-files directory by default) and can scan local IDE session stores (e.g. ~/.claude) and git history to recover context. Before installing: (1) review session-catchup.py and the hook scripts to confirm you are comfortable with the skill reading your local conversation/session files; (2) run it in a test or non-sensitive repository first; (3) remove or sandbox any IDE session folders you don't want the skill to access (or set environment variables the scripts use to point to a safe location); and (4) if you have highly sensitive session data, avoid granting the skill access or disable autonomous invocation in your agent until you've audited behavior.

The ultimate unified AI workflow combining persistent memory loops with high-speed TDD execution.

Features

• Persistent AI Memory: AI agents never "lose their spot" thanks to Manus-style file logging
• Dynamic TDD Loop: Built-in instructions for writing tests before code
• Workspace Clutter Control: All AI logs routed to unified directory
• Prompt-Driven Paths: Tell the agent where to save files directly in your prompt

Included Skills (15)

Skill	Purpose
using-superpowers	How to find and use skills
planning-with-files	Persistent memory loops
spf-write-plan	Create implementation plans
spf-exec-plan	Execute plans with TDD
test-driven-development	TDD workflow
systematic-debugging	Debug process
brainstorming	Idea generation
dispatching-parallel-agents	Multi-agent coordination
subagent-driven-development	Subagent patterns
requesting-code-review	PR review requests
receiving-code-review	Handle review feedback
finishing-a-development-branch	Branch completion
verification-before-completion	Pre-merge checks
using-git-worktrees	Worktree workflow
writing-skills	Create new skills

Quick Start

1. Clone the repository
2. Point your AI agent at the /skills folder
3. Use /spf-plan to create a plan
4. Use /spf-execute to implement

Source

https://github.com/mok888/superpower-with-files