sudocode

Translate source code into linear sudocode preserving identifiers and behavior.

21|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/kevinslin/skills --skill sudocode-kevinslin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sudocode
Source: https://github.com/kevinslin/skills/tree/main/active/sudocode
Command: npx skills add https://github.com/kevinslin/skills --skill sudocode-kevinslin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Write consistent sudocode from real code. Use whenever sudocode needs to be written, including flow docs, specs, architecture docs, or code-to-sudocode transformations.

Core Features & Use Cases

  • Preserve exact identifiers from source code for traceability.
  • Inline short referenced logic to keep sudocode readable and compact.
  • Preserve behavior-critical side effects and error paths to maintain fidelity.

Quick Start

Provide the source code and I will generate sudocode following the canonical rules.

Frequently Asked Questions about sudocode

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

FAQPage Schema
How do I convert source code into pseudocode for architecture documentation?

To convert source code into pseudocode, provide your code to generate a linear narrative preserving exact identifiers and behavior. This creates grepable flow docs, architecture specs, and documentation following canonical style rules.

What is the best way to write flow docs that preserve exact identifiers from code?

Writing flow docs that preserve exact identifiers requires translating source code into a linear pseudocode narrative. This approach maintains traceability by keeping original variable names and function signatures intact during the code-to-pseudocode transformation.

Does generating pseudocode from code preserve side effects and error paths?

Generating pseudocode from code preserves behavior-critical side effects and error paths to maintain fidelity. The transformation ensures that exception handling, state mutations, and control flow logic remain accurately represented in the resulting documentation.

Can I inline short helper functions when converting code to pseudocode?

You can inline short referenced logic when converting code to pseudocode to keep the narrative readable and compact. This inlining approach reduces documentation fragmentation by embedding concise helper implementations directly into the main flow.

Is code-to-pseudocode transformation applicable across multiple programming languages?

Code-to-pseudocode transformation is applicable across languages and projects for generating architecture specs and documentation. The process focuses on translating behavioral logic and identifiers into a standardized pseudocode format regardless of the source language syntax.

When should I not use pseudocode for code analysis and documentation?

You should avoid using pseudocode for documentation when your source code requires strict syntax validation or when visual structural representations like UML diagrams are needed instead of linear narrative text for architecture communication.