Agent Skills › InsForge/InsForge › ui

ui

GitHub

用于维护 InsForge monorepo 中可复用 UI 包，管理设计系统原语、导出、样式及组件行为。

.codex/skills/insforge-dev/ui/SKILL.md InsForge/InsForge

Trigger Scenarios

修改 packages/ui 下的组件或样式更新 UI 包的导出接口遵循 UI 包开发规范进行代码提交

Install

npx skills add InsForge/InsForge --skill ui -g -y

More Options

Non-standard path

npx skills add https://github.com/InsForge/InsForge/tree/main/.codex/skills/insforge-dev/ui -g -y

Use without installing

npx skills use InsForge/InsForge@ui

指定 Agent (Claude Code)

npx skills add InsForge/InsForge --skill ui -a claude-code -g -y

安装 repo 全部 skill

npx skills add InsForge/InsForge --all -g -y

预览 repo 内 skill

npx skills add InsForge/InsForge --list

SKILL.md

Frontmatter

{
    "name": "ui",
    "description": "Use this skill when contributing to InsForge's reusable UI package. This is for maintainers editing design-system primitives, exports, styles, and package-level component behavior in the InsForge monorepo."
}

InsForge Dev UI

Use this skill for packages/ui/ work in the InsForge repository.

Scope

packages/ui/src/components/**
packages/ui/src/lib/**
packages/ui/src/index.ts
packages/ui/src/styles.css

Working Rules

Put only reusable primitives here.
- If the component is generic across dashboard features or other InsForge apps, it belongs in packages/ui/.
- If it is tightly coupled to one dashboard workflow but should ship to both OSS and cloud hosts, keep it in packages/dashboard/.
- If it is only for the self-hosting host app, keep it in frontend/.
Preserve the package's implementation style.
- Use class-variance-authority for variants when appropriate.
- Use the shared cn() helper for class merging.
- Follow the existing Radix-wrapper and typed-export patterns.
Keep the public surface in sync.
- Export new public components from packages/ui/src/index.ts.
- Avoid adding internal-only abstractions to the package surface unless they are meant to be consumed.
- Never use the TypeScript any type. Keep component props and exported helpers strictly typed.
Validate downstream impact.
- The shared dashboard package consumes this package directly, so UI changes can break packages/dashboard/ even if packages/ui/ itself builds cleanly.

Validation

cd packages/ui && npm run build
cd packages/ui && npm run typecheck

Also validate packages/dashboard/ when the changed component is used in the dashboard, and validate frontend/ if the host app integration or CSS entrypoints changed.