feat: ✨ add SKILL.md files for features including

Author: tomgrv

src/act/stubs/.github/skills/feature-act/SKILL.md

@@ -0,0 +1,44 @@
+<!-- @format -->
+
+# act
+
+## Description
+
+Use this feature when an agent needs to run GitHub Actions workflows locally with Nektos `act` inside a dev container.
+
+## Use For
+
+## Do Not Use For
+
+## Agent Guidance
+
+# act
+
+## Description
+
+Use this feature when an agent needs to run GitHub Actions workflows locally with Nektos `act` inside a dev container.
+
+## Commands
+
+- `act` - Run GitHub Actions workflows locally.
+- `act -l` - List available workflows/jobs.
+- `act <event>` - Run workflows for a specific GitHub event.
+- `act-run` - Run repository wrapper flow around `act` defaults.
+- `act-reset` - Reset local state/artifacts used by `act` wrapper scripts.
+
+## Use For
+
+- Running CI workflows locally before push.
+- Reproducing workflow/job failures from GitHub Actions.
+- Fast validation of workflow YAML changes.
+
+## Do Not Use For
+
+- Editing workflow logic unrelated to execution.
+- Cloud deployment tasks.
+
+## Agent Guidance
+
+- Ensure Docker is available before running `act`.
+- Prefer running the minimal target job first, then full workflow if needed.
+- Use the feature version option when reproducibility is required.

src/common-utils/stubs/.github/skills/feature-common-utils/SKILL.md

@@ -0,0 +1,33 @@
+<!-- @format -->
+
+# common-utils
+
+## Description
+
+Use this feature as a shared utility layer for shell-based automation across features (`jq`, `dos2unix`, and `zz_*` helper scripts).
+
+## Commands
+
+- `validate-json [options] <json>` - Validate JSON against a schema.
+- `normalize-json [options] <json>` - Normalize JSON order/format using schema rules.
+- `zz_dist [options]` - Copy `zz_*` helpers to a target directory.
+- `zz_args` - Parse command-line arguments in shell scripts.
+- `zz_log` - Emit structured/colorized shell logs.
+- `zz_json` - Read or manipulate JSON from shell scripts.
+
+## Use For
+
+- JSON validation/normalization workflows (`validate-json`, `normalize-json`).
+- Shell scripting with standardized logging, argument parsing, and prompts (`zz_log`, `zz_args`, `zz_ask`).
+- Distributing shared helper scripts into project folders (`zz_dist`).
+
+## Do Not Use For
+
+- Feature-specific business logic.
+- Git workflow automation (use `gitutils` or `githooks`).
+
+## Agent Guidance
+
+- Reuse existing `zz_*` scripts before adding new helpers.
+- Prefer `normalize-json`/`validate-json` in lint pipelines for schema-safe edits.
+- Keep automation generic and composable for cross-feature reuse.

src/githooks/stubs/.github/skills/feature-githooks/SKILL.md

@@ -0,0 +1,34 @@
+<!-- @format -->
+
+# githooks
+
+## Description
+
+Use this feature when an agent needs consistent local Git quality gates and commit workflow automation.
+
+## Commands
+
+- `git commit` - Triggers `pre-commit`, `prepare-commit-msg`, and `commit-msg` hooks.
+- `git push` - Triggers `pre-push` validations before remote update.
+- `git checkout <branch>` - Triggers `post-checkout` hook operations.
+- `git merge` - Triggers `post-merge` hook operations.
+- `commitlint --edit <file>` - Validate a commit message against commitlint rules.
+- `lint-staged` - Run configured lint/format commands on staged files.
+
+## Use For
+
+- Enforcing commit message standards (`commitlint`, `commitizen`).
+- Running pre-commit checks/linting on staged files.
+- Validating branch naming and push readiness.
+- Keeping dependencies aligned after checkout/merge hooks.
+
+## Do Not Use For
+
+- Repository history rewriting (use `gitutils`).
+- Version calculation from history (use `gitversion`).
+
+## Agent Guidance
+
+- Treat hooks as the default guardrails for local commits.
+- Update hook-related package snippets/scripts instead of introducing duplicate checks.
+- When failures occur, fix the underlying issue and rerun the same hook path.

src/gitutils/stubs/.github/skills/feature-gitutils/SKILL.md

@@ -0,0 +1,38 @@
+<!-- @format -->
+
+# gitutils
+
+## Description
+
+Use this feature for advanced Git operations, interactive repository maintenance, and git-flow shortcuts.
+
+## Commands
+
+- `git align` - Align current branch with its remote tracking branch.
+- `git integrate` - Integrate remote modifications into current branch.
+- `git fixup [--force|<commit>]` - Amend a target commit and rebase history.
+- `git getcommit [--force|<commit>]` - Resolve/select commit target for fixup.
+- `git fix date [options] [<commit>]` - Rewrite commit times with scheduling rules.
+- `git forall <command>` - Execute a command for repository files.
+- `git release-beta` - Start a Git Flow release branch.
+- `git release-hotfix` - Start a Git Flow hotfix branch.
+- `git release-prod` - Finish release/hotfix flow for production.
+- `git unset <prefix> [--local|--global|--system]` - Remove git config keys by prefix.
+
+## Use For
+
+- Branch/rebase alignment and integration tasks.
+- Commit cleanup/fixup workflows.
+- Release branch shortcuts (`beta`, `hfix`, `prod`).
+- Batch repository operations and helper aliases.
+
+## Do Not Use For
+
+- Commit policy enforcement hooks (use `githooks`).
+- Semantic version calculation (use `gitversion`).
+
+## Agent Guidance
+
+- Prefer built-in aliases/utilities before crafting raw multi-step Git commands.
+- For history-rewrite actions, use explicit/force flags only when requested.
+- Keep operations scoped and reversible where possible.

src/gitversion/stubs/.github/skills/feature-gitversion/SKILL.md

@@ -0,0 +1,31 @@
+<!-- @format -->
+
+# gitversion
+
+## Description
+
+Use this feature when an agent must derive application version numbers from Git history in a consistent way.
+
+## Commands
+
+- `gv` - Compute version metadata from Git history.
+- `bump-version` - Update version fields/files from computed version.
+- `bump-tag` - Create/update version tag from release version.
+- `bump-changelog` - Generate or update changelog for release context.
+
+## Use For
+
+- Calculating semantic versions from branch/commit state.
+- Providing version metadata for build/release automation.
+- Aligning local version behavior with CI versioning.
+
+## Do Not Use For
+
+- Manual tag/edit workflows without GitVersion involvement.
+- Hook or lint orchestration (use `githooks`).
+
+## Agent Guidance
+
+- Use the installed GitVersion tooling as the source of truth for computed versions.
+- Keep versioning logic centralized; avoid duplicating derivation rules in scripts.
+- Pair with release helpers only when version flow is explicitly required.

src/larasets/stubs/.github/skills/feature-larasets/SKILL.md

@@ -0,0 +1,38 @@
+<!-- @format -->
+
+# larasets
+
+## Description
+
+Use this feature for Laravel-focused developer experience in dev containers, including artisan/sail wrappers, cache tasks, and PHP tooling presets.
+
+## Commands
+
+- `init` - Initialize Laravel project dependencies and environment defaults.
+- `sail <...>` - Run Laravel Sail commands.
+- `art <...>` - Run Artisan commands via local/Sail-aware wrapper.
+- `run <...>` - Run npm scripts via local/Sail-aware wrapper.
+- `srv <...>` - Run service process helpers (PM2-aware workflows).
+- `seed` - Run migrations and seed database data.
+- `fwd <...>` - Manage local-to-remote forwarding helper operations.
+- `composer lint` - Run Pint linting flow for project code.
+- `composer test` - Run Pest test suite.
+- `composer upg` - Update Composer dependencies with project defaults.
+
+## Use For
+
+- Running Laravel commands through `art`, `sail`, `run`, `srv` wrappers.
+- Bootstrapping Laravel local environment defaults.
+- Automating cache refresh tasks for config/views/routes.
+- Composer helper workflows tailored for Laravel monorepos.
+
+## Do Not Use For
+
+- Generic PHP extension installation (use `pecl`).
+- Kubernetes/local cluster workflows (use `minikube`).
+
+## Agent Guidance
+
+- Prefer provided wrapper commands over raw command variants for portability.
+- Use existing trigger-task patterns for cache-sensitive file changes.
+- Keep Laravel defaults local/dev oriented unless explicitly asked for production behavior.

src/minikube/stubs/.github/skills/feature-minikube/SKILL.md

@@ -0,0 +1,34 @@
+<!-- @format -->
+
+# minikube
+
+## Description
+
+Use this feature when an agent needs local Kubernetes capabilities inside the dev environment using Minikube.
+
+## Commands
+
+- `minikube start` - Start local Minikube cluster.
+- `minikube stop` - Stop local Minikube cluster.
+- `minikube status` - Check Minikube and Kubernetes component status.
+- `mkb` - Run feature-level Minikube helper wrapper.
+- `mkb-up` - Start Minikube using repository helper defaults.
+- `mkb-preload` - Preload container images used by local workflows.
+- `mkb-pds` - Run project-defined Minikube bootstrap/support flow.
+
+## Use For
+
+- Local Kubernetes cluster setup for development/testing.
+- Running and validating Kubernetes manifests in a single-node cluster.
+- Reproducing k8s workflow issues without remote infrastructure.
+
+## Do Not Use For
+
+- Production cluster provisioning.
+- PHP/Laravel-specific tooling concerns.
+
+## Agent Guidance
+
+- Verify Minikube runtime prerequisites before starting cluster actions.
+- Keep manifests and tests targeted to local/dev constraints.
+- Prefer incremental validation (namespace/app) before full environment rollout.

src/pecl/stubs/.github/skills/feature-pecl/SKILL.md

@@ -0,0 +1,32 @@
+<!-- @format -->
+
+# pecl
+
+## Description
+
+Use this feature when an agent needs to install or manage PHP extensions from PECL in the dev container.
+
+## Commands
+
+- `pecl install <extension>` - Install a PHP extension from PECL.
+- `pecl list` - List installed PECL extensions.
+- `pecl info <extension>` - Show metadata/details for an extension.
+- `php -m` - List loaded PHP modules to verify extension activation.
+- `php --ri <extension>` - Print runtime info for an activated extension.
+
+## Use For
+
+- Installing required PHP extensions declared by project dependencies.
+- Enabling extension support needed by tests or runtime.
+- Standardizing extension setup through feature configuration.
+
+## Do Not Use For
+
+- Laravel workflow automation (use `larasets`).
+- General system utility setup (use `common-utils`).
+
+## Agent Guidance
+
+- Install only extensions required by the project/task.
+- Keep extension configuration explicit and reproducible.
+- Validate PHP environment compatibility after extension changes.