implementation

Standardize code construction, refactoring, and deprecation workflows with type hints and documentation.

Updated Jan 5, 2025
One-click install
npx skills add https://github.com/pkuppens/pkuppens --skill implementation-pkuppens
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: implementation
Source: https://github.com/pkuppens/pkuppens/tree/main/skills/implementation
Command: npx skills add https://github.com/pkuppens/pkuppens --skill implementation-pkuppens

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Code construction, refactoring, and disciplined deletion guided by SKILL_TREE principles provide a repeatable, safe path for building and evolving software components.

Core Features & Use Cases

  • Enforces one purpose, minimal surface area, and intention-revealing names to improve maintainability.
  • Guides API design with type hints, docstrings, and defensive boundaries, reducing defects during integration.
  • Ideal for teams adopting consistent construction standards, performing refactors, or deprecating functionality with clarity and traceability.

Quick Start

Follow the standard process: define public signatures first, then implement with clear docstrings and tests to ensure correct behavior.

Frequently Asked Questions about implementation

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

FAQPage Schema
How do I standardize code construction and refactoring workflows for better maintainability?

Standardize code construction by enforcing one purpose per module, minimal surface area, and intention-revealing names. Define public signatures with type hints and docstrings first, then implement with tests to ensure correct behavior and reduce integration defects.

What is the best way to safely deprecate functionality in a software project?

Safely deprecate functionality by applying disciplined deletion workflows that maintain clarity and traceability. This approach ensures consistent design principles are followed, providing a repeatable path for evolving software components without breaking integration.

How do I enforce type hints and docstrings on public API interfaces?

Enforce type hints and docstrings on public interfaces by applying project-wide construction standards that require named signatures and defensive boundaries. Define public signatures first to ensure API design reduces integration defects.

When do I need to refactor existing modules for better code quality?

Refactor existing modules when adopting consistent construction standards or when code lacks intention-revealing names. This improves maintainability and ensures design principles are applied across new and existing software components.

Can I use these refactoring principles for both new and existing software projects?

Yes, these refactoring principles apply to both new and existing modules within a software project. They standardize code construction and deprecation workflows, ensuring consistent design principles, named signatures, and thorough documentation across the entire project.