Skill Scripting

Skill scripts are the primary way you implement agent logic on the Newo platform. Written in the Newo Script Language (NSL), skill scripts combine natural language prompts with programmatic logic to control how your AI Employee processes information, generates responses, and takes actions.

Articles in this section

Article	Description
Writing your first skill script	Step-by-step tutorial: create a skill in Builder, write NSL that retrieves user data, generates a response, and returns a result.
NSL quick reference	Compact syntax cheat-sheet covering delimiters, variables, conditionals, loops, filters, role tags, and scoping behavior.
Working with LLM generation	Deep dive into `Gen()` and `GenStream()` — parameters, role tags, structured JSON generation, interrupt modes, and streaming patterns.
Skill parameters and variables	Define parameters in flow YAML, pass values between skills, use result variables and result actions, and manage state across skill executions.
Calling sub-skills with Do	Invoke other skills from within a skill script using direct calls and the `Do()` action, pass parameters, and chain execution patterns.
Conditional logic and flow control	Use `if`/`elif`/`else` branching, `Return()` for early exit, `Sleep()` for delays, and non-interruptible blocks for atomic operations.

What you need

Access to the Newo Builder interface
A project with at least one agent and flow configured
Basic understanding of skills, flows, and events from the Core Concepts section

Changelog

Skill Scripting: initial publication

Published subsection overview page for the Skill Scripting developer guides.