native-nostalgia-stack
Applies the user's FreePascal toolchain and its build, formatting, hook, and test contracts while leaving project-specific mechanics local. Use when scaffolding or working in a FreePascal project that follows this toolchain.
How do I install this agent skill?
npx skills add https://github.com/frostney/known-good-route --skill native-nostalgia-stackIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides standard development guidelines and toolchain configuration for FreePascal projects. It defines code style, project structure, and build contracts using common tools like FPC and Lefthook without any detected security risks.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Native nostalgia stack
Apply only the contract material to the requested work. Project AGENTS and docs
own implementation rules and exact commands; project-structure/SKILL.md owns
language-neutral layout and documentation.
Compiler and layout
- Use the FPC version the project and CI pin; a new project pins the latest stable release. Use Delphi mode unless project docs explicitly choose another mode.
- Keep project-wide compiler directives in one shared include used by every unit.
- Put Pascal source under one root (
source/preferred), using namespaced filenames and a flat layout until a namespace becomes unwieldy. - Co-locate unit tests; keep delivered end-to-end corpora under root
tests/. - Put all ignored build output under root
build/. - Prefer executable InstantFPC for one-off Pascal scripts; use an existing task runner or dynamic language only when that is materially simpler.
Read references/code-style.md when writing or reviewing Pascal source.
Build contract
The project chooses the implementation but provides one root entry point:
- bare invocation performs a clean development build of all binaries;
- positional names select one or more binary targets;
- development is the default and a production flag selects release settings;
cleanis a target and can be combined with a target;- every binary lands under
build/.
Document the entry point, targets, and flags in docs/build-system.md; read it
before changing them.
Formatter and health contracts
One formatter/linter command rewrites Pascal by default and has a non-mutating
--check mode that exits non-zero on deviation. Project-specific style lives in
the tool and docs/code-style.md, not scattered config.
The codebase-health gate reports located duplication, per-function cyclomatic
and cognitive complexity, sortable file health, and complexity-times-churn
hotspots. Thresholds and ignores live in one root config; breaches exit
non-zero. Document the tool and thresholds in docs/tooling.md.
Hook
Lefthook runs the project's formatter check on staged Pascal and its build-and-test command. Use the exact project entry points, install the hook via the documented quick start, and never bypass it without explicit user direction.
Completion
- Root and area AGENTS were inspected,
fpc -iVmatches the project/CI pin, and any touched tool version was verified live before relying on its behavior. - The project formatter and build-and-test gates were observed passing.
- Only the authoritative docs affected by the change were updated.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/frostney/known-good-route/native-nostalgia-stack">View native-nostalgia-stack on skillZs</a>