# Build CI Local Script

> Run and modify scripts/build-ci-local.ps1 safely, keeping it aligned with scripts/modules and VS Code tasks. Use when this capability is needed.

- Skill: `tomevault-io/build-ci-local-script` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/build-ci-local-script`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/build-ci-local-script/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/build-ci-local-script

---


# build-ci-local.ps1 Workflow

## When to use

Use this skill when working on:

- `scripts/build-ci-local.ps1`
- Build pipeline steps, flags, or output
- How the script uses modules in `scripts/modules/Build` and `scripts/modules/Core`

## How it’s structured (repo-specific)

- Imports modules from `scripts/modules`:
  - `Core/Logging.psm1`
  - `Core/Prerequisites.psm1`
  - `Build/DotNetBuild.psm1`
  - `Build/PluginBuild.psm1`

## Safe changes

- Prefer adding reusable behavior in the appropriate module (`Build/*` or `Core/*`) and calling it from the script.
- Keep flags backward compatible when possible.

## Step-by-step procedure

1. Confirm which scenario is being modified (full CI, plugin-only, formatting, test docs).
2. Find the corresponding pipeline step in `scripts/build-ci-local.ps1`.
3. Prefer implementing reusable behavior in:

- `scripts/modules/Build/*` for build operations
- `scripts/modules/Core/*` for shared utilities/prereqs

4. Ensure the script continues to import modules from `$ModulesDir` (no hard-coded absolute paths).
5. Validate by running an appropriate command:

- Quick sanity: `pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 -SkipTests -SkipFormat`
- Full pipeline: `pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1`

## Examples (input → expected output)

### Example: Add a new optional build step

**Input:** “Add a flag to run an extra verification step.”

**Expected output:**

- A new `param()` switch with help text
- Step wired into the pipeline with clear output
- Reusable logic lives in a module if it’s non-trivial
- Script still works with existing flags and defaults

## How to run (examples)

- Full build: `pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1`
- Quick: `pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 -SkipTests -SkipFormat`
- Plugin-only: `pwsh -NoProfile -ExecutionPolicy Bypass -File scripts/build-ci-local.ps1 -PluginOnly -DeployPlugin`

## References

- Script docs: [scripts/README.md](../../../scripts/README.md)
- Module catalog: [scripts/modules/README.md](../../../scripts/modules/README.md)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/danielshue) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->