agentware: Skill for Claude Code

.claude/skills/onboarding/SKILL.md

onboarding is a skill for Claude Code from r5rana/agentware. It costs 0 tokens per session (12,196 once invoked), scanned B, original, Apache-2.0.

A first-run setup procedure for agentware, a steering framework whose personal knowledge base is stored outside the code repository. It asks where to keep that knowledge, checks the system and framework, and creates the external knowledge directory.

In plain words
What is it for?
Setting up agentware for a new operator, choosing the knowledge-base directory, and completing the one-time initialization.
Why use it?
It gives each operator a separate knowledge location without putting personal information into the shared repository.

Skill for Claude Code

Written for Claude Code: SessionStart hook event. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions subagents.

This is r5rana/agentware's own configuration. It tells Claude Code how to work on agentware itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything agentware configures →

Not installable: its command points at a path on the author’s own machine, so it runs nowhere else. The line is /Users/you/agentware.

Reuse

Borrowing it

Nothing to install: this file belongs to r5rana/agentware. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/r5rana/agentware/main/.claude/skills/onboarding/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/r5rana/agentware

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for onboarding

README.md
[![agentmods](https://agentmods.dev/badge/skills/r5rana/agentware/onboarding/github.svg)](https://agentmods.dev/skills/r5rana/agentware/onboarding)
Your own site
<a href="https://agentmods.dev/skills/r5rana/agentware/onboarding"><img src="https://agentmods.dev/badge/skills/r5rana/agentware/onboarding/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for onboarding

Your own site · 80×15
<a href="https://agentmods.dev/skills/r5rana/agentware/onboarding"><img src="https://agentmods.dev/badge/skills/r5rana/agentware/onboarding.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 12,196 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 2 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.12196
Opus 5.5 $0.00000 $0.04878
Sonnet 5.5 $0.00000 $0.02439
Haiku 4.5 $0.00000 $0.01220

Measured 1mo ago against content hash 0d71ce24acbb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade B, and why

onboarding scanned grade B with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Strips warnings and disclaimersmediumAnti-refusal

Omitting safety caveats hides risk from the user and is a common jailbreak preamble.

helpful. Don't lecture, don't pad. The user came here to do work; onboarding is

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

`curl -s http://localhost:1234/v1/models`) — see the feature's
.claude/skills/onboarding/SKILL.md · 852 lines

How it starts

The opening of the file, as written. The whole thing — 852 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Onboarding Skill — agentware First-Run Flow

When to invoke: when the external knowledge directory is not yet configured, OR its .initialized sentinel does not exist. Resolve the dir with scripts/agentware config --knowledge-dir-only. This is a one-time procedure per operator. Once it finishes, the sentinel is written and this skill never runs again for this instance.

agentware ships as a generic, personal-data-free steering framework. The repo contains ONLY the steering: methodology, agents, skills, the loop runner, and the deterministic toolkit. It contains no knowledge base. Onboarding is the flow that asks the operator where to keep their knowledge base, creates it OUTSIDE the repo, and personalizes it. The same clone works for anyone — each operator points it at their own knowledge directory.

It is interactive — the agent talks to the user, asks where to store knowledge, investigates the system (read-only), introspects agentware itself, then writes the knowledge base into the external directory.


The core design (state this to the user)

  • This repo is pure steering. Nothing personal is ever committed to it.
  • The knowledge base lives in a directory you choose, outside this repo (e.g. ~/agentware-knowledge or anywhere you like). It holds your profile, projects, learnings, and configs.
  • The repo finds your knowledge dir via ~/.agentware/config.env or the AGENTWARE_KNOWLEDGE_DIR environment variable.
  • Because the path is external and the config lives in HOME, you can push this repo publicly and share it — the clone is generic and stays read-only as you work.
  • Everything mutable goes to your dir: knowledge, learnings, agent-created skills, per-feature work (work/), AND a full audit log (logs/) — every prompt you send and every session transcript, timestamped, so you never lose anything. This logging is automatic via Claude Code hooks; no action needed from you.

Self-extension clause (always true)

Read the full file on GitHub · 852 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 852 lines · 0 tokens per session scan B 0d71ce24acbb

Subscribe to this mod's changes

onboarding is a skill published in the GitHub repository r5rana/agentware (24 stars, last pushed 2mo ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 12,196 tokens. A static security scan graded it B with 2 findings (strips warnings and disclaimers, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

Cortex

Operate Cortex, the LifeOS memory system — the typed Knowledge Archive (People, Companies, Ideas, Research with typed related: links) plus recall of prior work sessions, ISAs, and conversations. Search, add, harvest, develop, ingest, distill, graph-navigate, recall. USE WHEN cortex, knowledge, knowledge base, search…

danielmiessler/LifeOS · 196 tokens

wiki-dashboard

Create dynamic, queryable Obsidian dashboard views using Bases or Dataview. Use for auto-updating tables, indexes, or structured views of vault content; not for ordinary question answering.

Ar9av/obsidian-wiki · 42 tokens

Migrate

Intakes external content, classifies chunks against LifeOS taxonomy, commits with provenance. Sources: .md/.txt, stdin, LifeOS dirs, CLAUDE.md/Cursor/OpenAI Custom Instructions, Obsidian/Notion/Apple Notes exports. MigrateScan classifies → routing table. MigrateApprove with…

danielmiessler/LifeOS · 158 tokens

relevance-coarse-filter

Cheap, high-recall first-pass filter that removes obvious junk from a detector candidate pool before expensive story-origin research and PR judgment. Decides keep, monitoronly, or reject — never ranks, writes angles, verifies dates, or decides whether to pitch.

elvisun/newsjack · 57 tokens

daily-briefing

Proactive daily briefing that fires on a recurring schedule, pulls recent memory and workspace context, composes a structured summary (action items, progress, radar, next steps), and delivers it to all active channels. Enable with a time like "set up my daily briefing at 9am". Disable, reschedule, or check status at…

vellum-ai/vellum-assistant · 75 tokens

session-compact

AI DevKit · Compact a historical AI coding session with Jev when context is long, work is handed off or resumed, or durable continuation facts and memory candidates need extraction.

codeaholicguy/ai-devkit · 39 tokens