skills.rest
Valynt
ValyntOFFICIAL
Explore all skills by this author →
GitHub

agent-onboarding

Scaffold, validate, and register new ValueOS agents with tenant isolation.

Updated Nov 17, 2025
Search Tags:#typescript#onboarding#compliance#agent#scaffold#fabric
One-click install
npx skills add https://github.com/Valynt/ValueOS --skill agent-onboarding-valynt
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agent-onboarding
Source: https://github.com/Valynt/ValueOS/tree/main/.windsurf/skills/agent-onboarding
Command: npx skills add https://github.com/Valynt/ValueOS --skill agent-onboarding-valynt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Scaffold, validate, and onboard new agents into the ValueOS agent-fabric, ensuring consistent conventions and tenant isolation across the agent lifecycle.

Core Features & Use Cases

  • Scaffold a new agent file at packages/backend/src/lib/agent-fabric/agents/XAgent.ts by copying from references/agent-template.ts and replacing placeholders.
  • Enforce required properties (public readonly lifecycleStage, version, name) and proper memory system usage with tenant-scoped organization_id and organizationId.
  • Register the agent in the AgentFactory.ts, wiring imports, AGENT_LIFECYCLE_MAP, and FABRIC_AGENT_CLASSES, so the agent is discoverable and executable.
  • Provide a standardized test skeleton in the agents/tests directory to validate happy and failure paths, tenancy, and validation rules.
  • Maintain compliance with the repository's agent-fabric standards and trigger conditions for onboarding and agent reviews.

Quick Start

Provide the new agent details (name, lifecycle stage, risk profile) and run the scaffold-and-register flow to generate the agent file, update the factory, and wire up tests.

Frequently Asked Questions about agent-onboarding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new TypeScript agent and register it in the agent factory?▼

To scaffold a new agent, provide its name, lifecycle stage, and risk profile to generate the file from a template, then automatically wire imports and lifecycle maps into AgentFactory.ts for discovery.

What required properties must a TypeScript agent have to pass fabric compliance?▼

A compliant agent must declare public readonly lifecycleStage, version, and name properties, and enforce tenant-scoped memory via organization_id to pass BaseAgent conformity audits.

How does memory tenancy work when onboarding agents into the fabric?▼

Memory tenancy enforces tenant isolation by requiring organization_id and organizationId scoping within the agent's memory system during execution across all lifecycle stages.

Can I add an existing agent to the fabric without scaffolding a new file?▼

Yes, onboarding supports adding existing agents by auditing them for BaseAgent conformity, validating required fields, memory tenancy, and factory wiring without scaffolding a new file.

What is the best way to test agent validation rules and tenant isolation?▼

The best way to test agent validation is to use the standardized test skeleton generated in the agents/__tests__ directory to validate happy paths, failure paths, and tenancy rules.

Related Skills

Explore More Software Engineering Skills→
baekenoughbaekenough
34

create-agent

Create a new agent with directory structure and audit via mgr-supplier.

Community
Intermediate
mahg-esmahg-es
3

unit-test

Generate unit tests for functions, methods, and classes using the project's test framework.

Official
Intermediate
akashagl92akashagl92

Agents

Create trait-based agents with voice mappings and route tasks via AgentFactory.ts.

Community
Advanced
Rust-sohamRust-soham

golem-add-agent-ts

Create and register durable TypeScript agents in Golem components.

Community
Intermediate