system-scribe

Explain Super Cartola modules and business rules from repository source code.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/paulinett1508-dev/SuperCartolaManagerv5-production --skill system-scribe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: system-scribe
Source: https://github.com/paulinett1508-dev/SuperCartolaManagerv5-production/tree/main/.claude/skills/system-scribe
Command: npx skills add https://github.com/paulinett1508-dev/SuperCartolaManagerv5-production --skill system-scribe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of needing clear, reliable explanations of how Super Cartola features work internally, directly grounded in the real code and rules.

Core Features & Use Cases

  • Official documentation for features: Explains modules, rules, calculations, and internal behavior using the existing implementation as the source of truth.
  • Code-grounded research workflow: Encourages checking for the presence of gemini_audit.py and, if missing, using available read/search tools to consult the repository code instead of guessing.
  • Didactic, user-ready output: Produces structured explanations (rules, exceptions, examples, and related files) suitable for onboarding and day-to-day understanding.

Quick Start

Ask the system: "Explain how [module/feature X] works, including the main rules, exceptions, and a practical example, and cite the relevant files from the repository."

Frequently Asked Questions about system-scribe

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

FAQPage Schema
How do I generate accurate documentation for Super Cartola business rules and feature logic?

Generate documentation for Super Cartola business rules by consulting the repository source code via gemini_audit.py or Read/Grep fallbacks, producing structured didactic explanations with rules, exceptions, examples, and related files.

What is the best way to explain internal code calculations and financial flows to new developers?

The best way to explain internal calculations and financial flows is to ground explanations directly in repository source code, generating structured documentation that covers rules, exceptions, and practical examples for onboarding.

Does the documentation workflow work without the gemini_audit.py script installed?

Yes, the documentation workflow works without gemini_audit.py by falling back to standard Read and Grep tools to search and consult the repository source code for accurate feature explanations.

Can I use this approach to document feature logic for any repository module I need to understand?

Yes, you can document feature logic for any repository module by asking for explanations of specific system parts, which triggers a code-grounded search to produce structured wiki-style documentation of internal behavior.

Why should I use code-grounded analysis instead of guessing how a ranking system works?

Code-grounded analysis prevents hallucinations by reading actual repository source code to verify ranking rules, ensuring your documentation reflects real implementation logic including specific exceptions and calculations.

What limitations exist when generating wiki documentation from source code using read and grep fallbacks?

Using read and grep fallbacks for wiki generation limits deep automated analysis compared to a dedicated audit script, requiring manual search pattern construction to accurately trace complex module dependencies and business rules.