skills.rest
is-ivanov
is-ivanovCOMMUNITY
Explore all skills by this author →
GitHub

prompt-refactor

Scans prompt and documentation files for structural issues and refactors them according to rule-based validation requirements.

2|1|Updated Nov 7, 2025
Search Tags:#architecture#linting#documentation#compliance#refactor#prompt
One-click install
npx skills add https://github.com/is-ivanov/rpm-ddd --skill prompt-refactor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prompt-refactor
Source: https://github.com/is-ivanov/rpm-ddd/tree/main/.opencode/skills/prompt-refactor
Command: npx skills add https://github.com/is-ivanov/rpm-ddd --skill prompt-refactor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you identify and fix structural problems in prompt and documentation files, especially when files violate layer rules, use the wrong placement, or drift from the expected documentation structure.

Core Features & Use Cases

  • Prompt File Scanning: Reviews a single prompt file or a broader set of agents and skills for documentation issues.
  • Rule-Guided Refactoring: Uses predefined classification rules, loading rules, and a scan checklist to detect and correct problems systematically.
  • Practical Use Case: Useful when your repository contains multiple agent or skill instruction files and you want to standardize them before review, reuse, or team adoption.

Quick Start

Ask the assistant to use the prompt-refactor skill on a specific prompt file or to scan all agent and skill documentation files for structural issues.

Frequently Asked Questions about prompt-refactor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix structural issues and layer violations in prompt files?▼

Scan prompt files for layer violations and placement errors, then refactor them into a cleaner state using rule-based validation and a dedicated scan checklist to ensure documentation compliance.

What's the best way to standardize agent instruction files across a repository?▼

Standardize agent instruction files across a repository by running a repository-wide review that detects documentation drift, applies predefined classification rules, and corrects structural problems systematically for team adoption.

When do I need to refactor prompt architecture in documentation-driven AI workflows?▼

Refactor prompt architecture in documentation-driven AI workflows when your prompt and documentation files drift from expected structures, violate layer rules, or fail rule-based validation requirements before review or reuse.

Can I scan a single prompt file instead of reviewing all agent and skill documentation?▼

Scan a single prompt file instead of all agent and skill documentation by applying the skill to a specific file, allowing targeted cleanup of structural issues without running a full repository-wide review.

Does prompt refactoring work without external dependencies or components?▼

Prompt refactoring works without external dependencies by loading a dedicated refactor agent, a scan checklist, and repository-specific prompt architecture rules to validate and correct documentation structure internally.

Related Skills

Explore More Software Engineering Skills→
BartunekBartunek

get-qodo-rules

Load and apply Qodo coding rules across repository scopes before code changes.

Community
Intermediate
MRWillisTMRWillisT
7

write-a-skill

Creates agent skills with SKILL.md structure, progressive disclosure, and bundled resources for reuse.

Community
Intermediate
fengqiyu0317fengqiyu0317

document-guideline

Enforce documentation standards across design docs, READMEs, interfaces, and test cases.

Community
Advanced
rakovi4rakovi4
45

prompt-refactor

Detect and resolve structural and layer placement issues in documentation files.

Community
Intermediate