Skip to content

Reference: project scaffolding and agent skills

How-to: Project scaffolding.

New-NativeHTMLKitProject

Alias: New-NHKProject

Generates a runnable app folder: app.ps1 (UTF-8 with BOM, so Windows PowerShell 5.1 reads it correctly), index.html, style.css and an optional app.toml manifest. Refuses to overwrite any of these files without -Force. Run the app with pwsh -File ./app.ps1 (or powershell.exe -File .\app.ps1); app.toml is for launchers that start the host explicitly with Start-NativeHTMLKitHost and names pwsh, or powershell.exe with -WindowsPowerShell.

New-NativeHTMLKitProject [-Path] <string> [[-Name] <string>] [[-AppId] <string>] [-WindowsPowerShell] [-Force] [<CommonParameters>]
Parameter Type Required Default Description
-Path string yes - Destination folder; created when missing. Must not be a file.
-Name string no 'NativeHTMLKit PowerShell App' App name (1-128 characters, no quotes, backslashes or control characters).
-AppId string no 'org.example.PowerShellApp' Reverse-DNS identity written to app.ps1 and app.toml.
-WindowsPowerShell switch no off Make app.toml start powershell.exe instead of pwsh. Alias: -WindowsPowerShell51.
-Force switch no off Overwrite existing generated files.

Returns the folder's System.IO.DirectoryInfo.

New-NativeHTMLKitProject -Path ./InventoryTool -Name 'Inventory tool' -AppId 'org.example.InventoryTool'
pwsh -File ./InventoryTool/app.ps1

Install-NativeHTMLKitSkill

Alias: Install-NHKSkill

Installs, inspects or removes the nativehtmlkit-powershell coding-agent skill (bundled in the module under skills/) for Claude Code, Codex, OpenCode, GitHub Copilot, Cursor and Gemini CLI. User scope writes below your home folder; project scope below -ProjectPath:

Agent User scope Project scope
claude ~/.claude/skills .claude/skills
codex ~/.agents/skills .agents/skills
opencode ~/.config/opencode/skills .opencode/skills
copilot ~/.copilot/skills .github/skills
cursor ~/.cursor/skills .cursor/skills
gemini ~/.gemini/skills .gemini/skills

An installed folder carries a .nativehtmlkit-managed.json record of its file hashes. Folders not installed by this command (unmanaged) or edited since (modified) are never replaced or removed without -Force; links and junctions in the destination path are refused.

Install-NativeHTMLKitSkill [[-Action] <string>] [[-Agents] <string[]>] [[-Scope] <string>] [[-ProjectPath] <string>] [-Force] [-DryRun] [<CommonParameters>]
Parameter Type Required Default Description
-Action string no 'install' install, status or uninstall. One of: install, status, uninstall.
-Agents string[] no @('all') Agent names (also comma-separated) or all.
-Scope string no 'user' user or project. One of: user, project.
-ProjectPath string no - Existing project folder; required with -Scope project, not allowed with user.
-Force switch no off Replace or remove unmanaged or modified skill folders.
-DryRun switch no off Report what would happen without changing anything.

Returns one object per agent: Agent, Scope, State (missing, installed, modified, unmanaged), Path, Action (installed, removed, none, status, would-<action>).

Install-NativeHTMLKitSkill -Action status -Agents claude,codex -Scope project -ProjectPath .

Source: nativehtmlkit-powershell/docs/reference/tooling.md ยท edit the page there.