---
title: "pirafrank-skills"
description: "A portable collection of safe, practical agent skills for terminal workflows and configuration."
canonical: https://agentpluginsdirectory.com/plugins/pirafrank-skills
last-updated: 2026-09-28
---

# pirafrank-skills
A portable collection of safe, practical agent skills for terminal workflows and configuration.
- Slug: pirafrank-skills
- Publisher: Francesco Pira
- Repository: https://github.com/pirafrank/skills
- Manifest: plugin.json
- Version: 1.0.0
- License: MIT
- Category (editorial): productivity
- Skills: 15 (agent-config-audit, autonomous, build-repair, database-review, debug, dotfiles-config, find-tool, implement, investigate, mangpt, plan, review, security-review, system-design, tdd)
- MCP servers: 0
- Stars: 0
- Repository created: 2026-08-06
- Repository last pushed: 2026-08-31
- Publisher type: User
- Listing: https://agentpluginsdirectory.com/plugins/pirafrank-skills
- Schema: https://agent-plugins.org/schemas/1.0.0/plugin.schema.json

## What pirafrank-skills does, in the publisher's words

A portable, source-controlled engineering layer for coding agents. This repository is an Agent Plugins v1 package: plugin.json and skills/ are its portable plugin core.

It is intentionally separate from the machine-specific dotfiles harnesses. This repository defines how an agent should reason and work; dotfiles configures how a particular runtime, currently Pi, discovers and executes that guidance.

- Portable by default. Skills remain compatible with Agent Plugins v1 and can be consumed without adopting Pi or any other harness.
- Composable instead of monolithic. A task combines shared policy with a role and only the relevant language/domain profile, avoiding a large "do-everything" agent prompt.
- Repository-led execution. Existing just, make, package scripts, wrappers, pinned toolchains, and pre-commit checks take precedence over invented commands.
- Bounded autonomy. Commits, dependency installation, destructive actions, external changes, and ambiguous shell commands remain approval-gated.

From the project README, punctuation lightly normalized. Full text: https://raw.githubusercontent.com/pirafrank/skills/HEAD/README.md

## Skills

- agent-config-audit: Audit coding-agent instructions, skills, roles, and automation for safety and portability.
- autonomous: Carry out a bounded end-to-end local implementation workflow.
- build-repair: Diagnose a repository build, lint, type-check, or test failure.
- database-review: Review database-facing changes for correctness, migration, and operational risk.
- debug: Diagnose and repair a reproducible failure with evidence.
- dotfiles-config: Research an installed CLI tool and generate a safe, version-aware user configuration or dotfile in its native format, usually TOML. Use when a user wants to configure a CLI quickly, create a starter dotfile, discover where a tool reads configuration, translate examples into a working config, or ins…
- find-tool: Find locally available commands and scripts by capability, inspect the current user's PATH, and diagnose command resolution, aliases, functions, duplicates, and shadowing without running unknown programs, installing anything, browsing the internet, or changing shell configuration. Use for requests…
- implement: Implement a scoped repository change with focused validation.
- investigate: Investigate a focused repository question without modifying files.
- mangpt: Understand unfamiliar command-line tools and utilities by running bounded, help-only probes and interpreting their output into exact usage guidance. Use when a command has no useful man page, the user asks how to use an unfamiliar tool, or help may be exposed through --help, help, -help, -h, or a r…
- plan: Create an evidence-backed implementation plan for a repository change.
- review: Independently review a change for correctness, regressions, and scope.
- security-review
- system-design
- tdd

Descriptions come from the frontmatter of each SKILL.md, punctuation lightly normalized.