Instructions file
Instructions for vladkesler/initrunner, covering initrunner and project map.
Instructions file
Instructions for vladkesler/initrunner, covering initrunner and project map.
Agent
This guide shows how to configure each built-in tool type using real examples from examples/roles/. For the full configuration reference (all fields, defaults, types), see tools.md. For writing custom tools and plugins, see toolcreation.md.
Agent
InitRunner's role registry lets you install, share, and discover roles from InitHub and OCI registries. Roles are downloaded, validated, and saved to /.initrunner/roles/ where they integrate automatically with the CLI.
Agent
InitRunner provides a single initrunner new command for creating role.yaml files. It supports multiple seed modes (templates, AI generation, examples, hub bundles, or local files) and an interactive refinement loop for iterating on the YAML before saving. Run with no arguments in a terminal and it shows a guided start…
Agent
Services are curated always-on agents: start once, they run on a schedule, report status, and stop without requiring YAML. Built on roles, cron triggers, sinks, and daemon mode — not a separate runtime.
Agent
Skills are self-contained bundles of tools and system prompt instructions packaged as Markdown files. They enable composition and reuse across agents — define a capability once, reference it from any role. Skills use the SKILL.md format (compatible with the agentskills.io standard) with InitRunner extensions for tool…
Agent
This guide covers the four ways to extend InitRunner with tools: built-in tools (contributing to InitRunner itself), custom tools (Python modules), declarative API tools (YAML-only), and the plugin registry (distributable packages).
Agent
Tools give agents the ability to interact with the outside world — reading files, making HTTP requests, connecting to MCP servers, calling APIs, or running custom Python functions. They are configured in the tools list of a role definition. A bare name (- search) enables a tool with defaults; a mapping adds options (…
Skill Claude CodeCodex
Analyze endpoint latency trends using historical check data from memory. Detects slow degradation, spikes vs sustained issues, and calculates baseline deviations.
Skill Claude CodeCodex
Validate API response structure and content. Detects schema drift, unexpected null values, and abnormal response sizes.
Skill Claude CodeCodex
Check SSL/TLS certificate expiry and chain validity using openssl. Alerts on certificates expiring within 30 days.
Skill Claude CodeCodex
Translate natural language image descriptions into detailed, structured DALL-E prompts with subject, style, composition, lighting, and mood specifications.
Skill Claude CodeCodex
Classify incoming emails into triage categories using content analysis, sender profile memory, and thread detection. Produces a category (URGENT, REPLYNEEDED, FYI, NEWSLETTER, NOTIFICATION, SPAM) with confidence and reasoning.
Skill Claude CodeCodex
Draft context-aware email replies that match sender tone, reference thread history, and follow the user's style preferences. Presents drafts for review before sending.
Skill Claude CodeCodex
Curl-based HTTP endpoint probing and response validation. Tests status codes, response bodies, headers, and schema conformance against expected contracts.
Skill Claude CodeCodex
Shell-based database connectivity and integrity checks. Verifies that databases are reachable, schemas match expectations, and data integrity constraints hold.
Skill Claude CodeCodex
Environment variable validation and configuration verification. Checks that required variables are set, config files parse correctly, ports are available, and system dependencies meet version requirements.
Skill Claude CodeCodex
Health endpoint verification and dependency status checks. Probes standard health paths, validates dependency connectivity, and reports overall service readiness.
Skill Claude CodeCodex
Diagnose and fix Kubernetes pods, services, networking, storage, and rollout failures with kubectl. Safety-first, read-only by default.
Skill Claude CodeCodex
Decompose mathematical problems into sub-expressions, evaluate each one with the calculator tool, and present the full working chain. Handles arithmetic, trigonometry, logarithms, and financial formulas.
Skill Claude CodeCodex
Compare two or more PDF documents by extracting targeted sections, building a structured comparison matrix, and highlighting differences with page references.
Skill Claude CodeCodex
Dockerfile security review. Checks for running as root, leaked secrets in build layers, insecure base images, and missing best practices.
Skill Claude CodeCodex
JavaScript and Node.js security scanning. Checks dependency vulnerabilities via npm audit and source patterns for XSS, eval, and prototype pollution.
Skill Claude CodeCodex
Python static analysis using bandit. Identifies injection, deserialization, unsafe exec/eval, weak crypto, and hardcoded credentials in Python code.