pfc-skill-pack
Govern Asphalt-Codex-Skills-5 as a PFC 5.0-only asphalt-mixture package, enforcing version purity, external fistPkg boundaries, portable assets, validation, and release hygiene.
SKILL.mdskills/pfc-skill-pack/SKILL.md
GitHubPFC 5 Asphalt Skill Pack Governance
Use this skill when maintaining, auditing, packaging, or releasing this repository. Modeling tasks start at pfc5-asphalt-workflow; this skill owns repository policy.
When To Use
- add, remove, rename, or audit a skill;
- check PFC 5.0 version purity;
- update dependencies, metadata, indexes, or release notes;
- decide whether a PFC/fistPkg asset may be bundled;
- validate links, paths, scripts, examples, or generated files.
Non-Negotiable Scope
- The package targets PFC2D/PFC3D 5.0 asphalt-mixture work only.
- Unsupported-major-version commands, APIs, examples, documentation, and migration routes are not retained.
- fistPkg, commercial manuals, DLLs, projects, saves, and standards text stay external.
- Bundled PFC scripts must state
static_validatedorruntime_validated; static inspection never implies a successful solve. - Public paths are relative or use placeholders such as
<FISTPKG_ROOT>.
Required Inputs
- proposed files and target PFC product;
- source/provenance and redistribution status;
- affected sibling skills and dependency paths;
- validation evidence and runtime availability;
- expected user-facing routing change.
Workflow
- Classify the change as governance, PFC source, Python tooling, example data, or external dependency contract.
- Reject out-of-scope version content before detailed review.
- When a licensed PFC5 help tree is available, bind command claims to relative page
locators using
references/pfc5-help-audit.md; do not copy or commit the help tree. - Keep
SKILL.mdconcise and move detailed reusable material toreferences/orscripts/. - Update
dependencies.jsonfor every cross-skill asset. - Run the validator, Python tests, AST compilation checks, and relevant demo/smoke tests.
- Confirm every slug in
references/pfc5-skill-set.jsonexists and every migrated capability is accounted for inreferences/migration-coverage.md. - Regenerate
references/skill-index.mdand review the final diff. - Record any unpassed PFC runtime gate explicitly.
Release Gates
- no unsupported-version markers or newer-major command families outside the validator itself;
- no absolute private paths, credentials, opaque binaries, caches, generated saves, or project files;
- no broken local links or missing dependency assets;
- every Markdown or inline-code reference to a sibling skill asset is covered by that
skill's
dependencies.jsonentry; - every inline-code
pfc...skill-like reference in aSKILL.mdresolves to an installed skill directory or the validator's explicit non-skill allowlist; - Agent metadata descriptions stay concise;
- demo inputs exist and runnable Python examples complete;
- external third-party assets have a documented contract and are not vendored.
Output Contract
Return the retained skill list, removed/out-of-scope assets, validator/test results, runtime-validation status, third-party boundaries, and exact unresolved risks.
Local Contents
references/asset-inventory.md— PFC5 packaging classes and inclusion rules.references/pfc5-help-audit.md— relative official-help locators and corrected command semantics; the commercial help stays external.references/migration-coverage.md— retained, rewritten and deliberately excluded capabilities.references/pfc5-skill-set.json— portable copy of the required package skill set; release validation keeps it identical to the repository manifest.templates/case-intake.md— repository change intake.scripts/build_skill_index.py— index helper.README.md— short package policy summary.LICENSEandNOTICE.md— retained MIT terms and upstream provenance.