# Onboarding

> Getting started guide for new users. Walks through setup validation, the skill/agent hierarchy,

- **Type:** Skill
- **Install:** `agentstack add skill-ulises-jeremias-agent-toolkit-onboarding`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ulises-jeremias](https://agentstack.voostack.com/s/ulises-jeremias)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ulises-jeremias](https://github.com/ulises-jeremias)
- **Source:** https://github.com/ulises-jeremias/agent-toolkit/tree/main/plugins/agent-toolkit-complete/.github/skills/onboarding
- **Website:** https://ulises-jeremias.github.io/agent-toolkit-archive/

## Install

```sh
agentstack add skill-ulises-jeremias-agent-toolkit-onboarding
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Onboarding

Welcome to . This skill guides new users through initial setup and daily usage.

## When to use

- User asks "where do I start?" or "how does this work?"
- First-time setup after `chezmoi apply`
- Troubleshooting a broken installation
- Onboarding a teammate

## Step 1 — Validate setup

```bash
doctor
```

Expected: `result: COMPLIANT`. If any check fails, `doctor` shows the fix command.

For persistent issues:

```bash
update-check            # check for available updates
skills list             # verify skills are installed
skills sync             # re-sync symlinks to AI tools
```

## Step 2 — Understand the hierarchy

```text
User message
    ↓
Orchestrator (assistant)
    ↓ routes to
Workflow skill (WHAT — decides scope and gates)
    e.g. workflow-generic-project
    ↓ delegates to
Tool skill (HOW — executes CLI commands)
    e.g. clickup-cli, github-cli-workflow
```

**Skills** are invoked via the skill tool (e.g. `/planning`).
**Agents** are invoked via `@mention` (e.g. `@planner`). Never use the skill tool for agents.

## Step 3 — First commands by role

### Developer

```bash
# Start any task
/workflow-generic-project

# After code changes — review before PR
@code-reviewer

# CI failing
/gh-fix-ci
```

### Product Manager / Tech Lead

```bash
# Plan a feature
@planner

# Create a ClickUp task
/clickup-cli  # then: clickup task create --current --name "..."

# Project health check
/project-assessment
```

### Anyone

```bash
# Check workstation health
doctor

# Find which skill to use
# → ask the orchestrator: "what skill should I use for X?"

# Load client/project context
./bin/workspace-context load packs/.yaml   # if in an agentic-harness workspace
```

## Key concepts in 60 seconds

| Concept | What it means |
|---------|--------------|
| **Pack** | Context bundle for a client/project (repos, constraints, commands) |
| **Skill** | Reusable AI prompt for a specific task (WHAT or HOW) |
| **Agent** | Specialized AI persona with restricted tool access (invoked via @mention) |
| **Loop** | Recurring autonomous process with state, tiers, and cost budgets |
| **L1 / L2 / L3** | Loop autonomy tiers: L1=observe-only, L2=PR-gated, L3=unattended |
| **knowledge/** | Persistent memory across sessions |

## Anti-patterns

- Do not skip `doctor` — it catches 90% of setup issues
- Do not invoke agents via the skill tool — use `@mention`
- Do not run L3 loops without 3+ clean L1 runs first

## Next steps

- Load a project pack: `./bin/workspace-context load packs/.yaml`
- Run your first task: `/workflow-generic-project`
- Set up daily loop: `agent-toolkit loop init daily-triage`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ulises-jeremias](https://github.com/ulises-jeremias)
- **Source:** [ulises-jeremias/agent-toolkit](https://github.com/ulises-jeremias/agent-toolkit)
- **License:** MIT
- **Homepage:** https://ulises-jeremias.github.io/agent-toolkit-archive/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-ulises-jeremias-agent-toolkit-onboarding
- Seller: https://agentstack.voostack.com/s/ulises-jeremias
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
