@lazyingart/agintiflow 0.12.11 → 0.14.0

package/README.md

@@ -75,7 +75,7 @@ For code edits, AgInTiFlow routes patch/refactor/database-style tasks to DeepSee
 
 For larger repositories, use `--profile large-codebase` or choose **Large codebase engineering** in the web UI. The web default stays **Auto**, and Auto now escalates codebase/system/debugging prompts to the same engineering loop when needed. Complex work routes to DeepSeek v4 pro, starts with `inspect_project`, then uses search/read/patch/check loops inspired by Codex, Copilot SDK, Claude Code, Gemini CLI, Qwen, and Claw Code. See [docs/large-codebase-engineering.md](docs/large-codebase-engineering.md).
 
-AgInTiFlow can also spend cheap DeepSeek calls on parallel scout notes before the main executor starts a complicated task. It first builds a bounded `inspect_project` context pack, then runs scouts for architecture, implementation, review, research, context mapping, tests, git workflow, integration, symbol tracing, and dependency risks. A coordinator Swarm Board is injected for the main agent. The executor still does the real file/shell/browser work itself. Disable with `--no-parallel-scouts` or set `--scout-count 1..10`.
+AgInTiFlow can also spend cheap DeepSeek calls on parallel scout notes before the main executor starts a complicated task. It first writes a bounded project map to `.aginti/codebase-map.json`, then runs scouts for architecture, implementation, review, research, context mapping, tests, git workflow, integration, symbol tracing, and dependency risks. A coordinator Swarm Board is injected for the main agent and saved as `artifacts/scout-blackboard.json` in the session. The executor still does the real file/shell/browser work itself. Disable with `--no-parallel-scouts` or set `--scout-count 1..10`.
 
 The next productive-agent roadmap is tracked in [docs/productive-agent-roadmap.md](docs/productive-agent-roadmap.md): durable codebase maps, stronger scout blackboards, long-run checkpoints, LSP/symbol tools, test triage, and release automation.
 
@@ -83,6 +83,16 @@ For current docs, install errors, package/toolchain setup, and source discovery,
 
 For raster image work, AgInTiFlow has an optional `image_generation` skill backed by the `generate_image` tool and a local `GRSAI` key. The skill tells DeepSeek when image generation is appropriate; the tool calls GRS AI Nano Banana, saves manifests/images under `artifacts/images`, and sends the result to the canvas. See [docs/auxiliary-image-generation.md](docs/auxiliary-image-generation.md).
 
+AgInTiFlow now ships a Markdown skill library in `skills/<id>/SKILL.md`. Skills are prompt playbooks, while tools are deterministic actions such as `apply_patch`, `run_command`, `web_search`, `generate_image`, and `send_to_canvas`. Built-in skills cover code, websites/apps, LaTeX manuscripts, books, Word documents, image generation, GitHub, system maintenance, Android, R/Stan, Python, C/C++, shell, AAPS, and novel writing. See [docs/skills-and-tools.md](docs/skills-and-tools.md).
+
+```bash
+aginti skills
+aginti skills website
+aginti --list-skills latex
+# in chat:
+/skills github commit
+```
+
 Launch the local web UI from an installed package:
 
 ```bash

package/docs/large-codebase-engineering.md

@@ -99,9 +99,9 @@ DeepSeek calls are cheap enough that complex tasks can use several short advisor
 - Symbol tracer: predicts names, APIs, routes, schemas, and searches that connect the change.
 - Dependency doctor: checks package managers, Docker/toolchain setup, generated artifacts, and install risks.
 
-Before scouts run, AgInTiFlow builds a bounded shared context pack with `inspect_project`: manifests, top-level files, source/test directories, package scripts, language counts, git status hints, and recommended reads. This avoids the weak pattern of each scout rediscovering the repo differently or flooding the main context with an infinite tree.
+Before scouts run, AgInTiFlow builds a bounded shared context pack from a durable project map at `.aginti/codebase-map.json`: manifests, top-level files, source/test directories, package scripts, language counts, git status hints, and recommended reads. This avoids the weak pattern of each scout rediscovering the repo differently or flooding the main context with an infinite tree.
 
-Scout output is synthesized by a coordinator Swarm Board and injected as advisory context only. The board records shared context, execution order, conflicts/unknowns, must-read files/checks, and stop conditions. The main agent still owns execution and must use real tools to inspect, edit, run commands, and finish. CLI flags:
+Scout output is synthesized by a coordinator Swarm Board, persisted as `artifacts/scout-blackboard.json`, and injected as advisory context only. The board records shared context, execution order, conflicts/unknowns, must-read files/checks, and stop conditions. The main agent still owns execution and must use real tools to inspect, edit, run commands, and finish. CLI flags:
 
 ```bash
 aginti --parallel-scouts --scout-count 10 "fix this complicated repo bug"

package/docs/productive-agent-roadmap.md

@@ -19,8 +19,8 @@ AgInTiFlow should become a practical coding agent, not only a chat UI around a m
 
 ## Missing Productive-Agent Pieces
 
-1. Durable codebase map: cache `inspect_project`, symbol locations, test commands, package scripts, and recently changed files per project.
-2. Scout blackboard: let scouts write short structured findings to a shared board, then run a coordinator pass that resolves conflicts before execution.
+1. Durable codebase map: cache `inspect_project`, symbol locations, test commands, package scripts, and recently changed files per project. Initial slice implemented as `.aginti/codebase-map.json` with manifests, source/test dirs, package scripts, languages, git hints, and recommended reads.
+2. Scout blackboard: let scouts write short structured findings to a shared board, then run a coordinator pass that resolves conflicts before execution. Initial slice implemented as per-session `artifacts/scout-blackboard.json` with role lanes, findings, coordinator handoff, and codebase-map metadata.
 3. Long-run checkpoints: save phase state after inspect, patch, test, repair, and commit so a long task can recover after interruption.
 4. Symbol/LSP tools: add find-definition, references, diagnostics, and document-symbols for JS/TS, Python, Rust, Go, and C/C++ where available.
 5. Test triage: parse common test failures into file, symbol, command, and likely cause so repair loops stay narrow.
@@ -30,6 +30,6 @@ AgInTiFlow should become a practical coding agent, not only a chat UI around a m
 
 ## Swarm Design
 
-Scouts must not become noisy subagents. Each scout gets the same bounded context pack and one role. The coordinator produces a Swarm Board with shared context, execution order, disagreements, must-read files, checks, and stop conditions. The main agent still owns tool use and must re-read exact files before editing.
+Scouts must not become noisy subagents. Each scout gets the same bounded context pack generated from the durable codebase map and one role. The coordinator produces a Swarm Board with shared context, execution order, disagreements, must-read files, checks, and stop conditions. The main agent still owns tool use and must re-read exact files before editing.
 
 Use 3 scouts for medium tasks, 5 for large tasks, and up to 10 for complex multi-language or system tasks. More scouts are only useful when their roles cover different failure modes.

package/docs/skills-and-tools.md

@@ -0,0 +1,58 @@
+# Skills And Tools
+
+AgInTiFlow separates **skills** from **tools** so the agent can stay general while still improving on specialized work.
+
+## Definitions
+
+**Skill**: Markdown guidance stored at `skills/<id>/SKILL.md`. A skill describes when to use a workflow, what to inspect first, which outputs matter, and which tools are usually useful. Skills are prompt context, not executable code.
+
+**Tool**: A deterministic callable capability exposed to the model, such as `inspect_project`, `read_file`, `apply_patch`, `run_command`, `web_search`, `generate_image`, `preview_workspace`, or `send_to_canvas`.
+
+**Profile**: A broad runtime mode such as `auto`, `code`, `latex`, or `maintenance`. Profiles tune routing, max steps, and general behavior. Skills can combine across profiles.
+
+## Built-In Skills
+
+The package ships built-in skills for code engineering, website/app building, LaTeX manuscripts, books, Microsoft Word documents, image generation, GitHub maintenance, system maintenance, Android, R/Stan, Python, C/C++, shell scripting, AAPS, and novel writing.
+
+List them from a project:
+
+```bash
+aginti skills
+aginti skills website
+aginti --list-skills latex
+```
+
+Inside interactive chat:
+
+```text
+/skills
+/skills github commit
+```
+
+## Selection Flow
+
+For every run, AgInTiFlow scores the user goal and active profile against skill frontmatter:
+
+```yaml
+---
+id: latex-manuscript
+label: LaTeX Manuscript
+description: Write, compile, and package LaTeX papers, reports, figures, bibliographies, and PDFs.
+triggers:
+  - latex
+  - tex
+  - manuscript
+tools:
+  - write_file
+  - apply_patch
+  - run_command
+---
+```
+
+Selected skills are injected into the plan and execution prompts. The LLM still decides what to do; skills only provide domain playbooks and guardrails.
+
+## Adding A Skill
+
+Create `skills/<id>/SKILL.md` with valid YAML frontmatter and a short Markdown body. Keep descriptions strings, not YAML arrays, because loaders expect `id`, `label`, and `description` as scalar strings.
+
+Good skills are small, actionable, and tool-aware. They should say what to inspect, what to create or verify, and what to avoid. They should not hard-code one exact task.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lazyingart/agintiflow",
-  "version": "0.12.11",
+  "version": "0.14.0",
   "type": "module",
   "description": "AgInTiFlow is a resumable Playwright website-control agent with OpenAI-compatible tool calling.",
   "license": "Apache-2.0",
@@ -46,10 +46,12 @@
     "scripts/smoke-coding-tools.js",
     "scripts/smoke-capabilities.js",
     "scripts/smoke-inbox.js",
+    "scripts/smoke-skills.js",
     "scripts/smoke-toolchain-docker.js",
     "scripts/smoke-web-api.js",
     "src/",
     "run.js",
+    "skills/",
     "web.js"
   ],
   "bin": {
@@ -64,11 +66,12 @@
     "smoke:coding-tools": "node scripts/smoke-coding-tools.js",
     "smoke:auxiliary-tools": "node scripts/smoke-auxiliary-tools.js",
     "smoke:cli-chat": "node scripts/smoke-cli-chat.js",
+    "smoke:skills": "node scripts/smoke-skills.js",
     "smoke:toolchain-docker": "node scripts/smoke-toolchain-docker.js",
     "smoke:inbox": "node scripts/smoke-inbox.js",
     "smoke:web-api": "node scripts/smoke-web-api.js",
     "real:deepseek": "node scripts/real-deepseek-capabilities.js",
-    "test": "npm run check && npm run smoke:web-api && npm run smoke:coding-tools && npm run smoke:auxiliary-tools && npm run smoke:capabilities && npm run smoke:cli-chat && npm run smoke:inbox",
+    "test": "npm run check && npm run smoke:web-api && npm run smoke:coding-tools && npm run smoke:auxiliary-tools && npm run smoke:capabilities && npm run smoke:skills && npm run smoke:cli-chat && npm run smoke:inbox",
     "pack:dry-run": "npm pack --dry-run",
     "smoke:capabilities": "node scripts/smoke-capabilities.js"
   },

package/scripts/smoke-capabilities.js

@@ -81,6 +81,14 @@ try {
     capabilities.trustedDockerPolicy.some((check) => check.command.startsWith("chmod") && check.allowed),
     "trusted Docker policy did not allow chmod"
   );
+  assert(
+    capabilities.tools?.skills?.some((skill) => skill.id === "website-app"),
+    "capabilities did not report built-in website skill"
+  );
+  assert(
+    capabilities.tools?.skills?.some((skill) => skill.id === "latex-manuscript"),
+    "capabilities did not report built-in LaTeX skill"
+  );
 
   const doctor = JSON.parse(await runCli(["doctor", "--capabilities", "--json"]));
   assert(doctor.project.root === tempRoot, "doctor --capabilities used the wrong project root");
@@ -91,7 +99,7 @@ try {
       {
         ok: true,
         projectRoot: tempRoot,
-        checks: ["aginti-md-init", "capabilities-cli", "doctor-capabilities", "maintenance-policy", "trusted-docker-policy", "git-policy"],
+        checks: ["aginti-md-init", "capabilities-cli", "doctor-capabilities", "maintenance-policy", "trusted-docker-policy", "git-policy", "skills-capability"],
       },
       null,
       2

package/scripts/smoke-cli-chat.js

@@ -122,6 +122,10 @@ try {
   if (!instructionsResult.stdout.includes("AGINTI.md") || !instructionsResult.stdout.includes("Project instructions")) {
     throw new Error("interactive /instructions did not show AGINTI.md");
   }
+  const skillsResult = await runChat("/skills website\n/exit\n");
+  if (!skillsResult.stdout.includes("website-app") || !skillsResult.stdout.includes("Website And App Builder")) {
+    throw new Error("interactive /skills did not show matching built-in skills");
+  }
   await runChat("remember that this project prefers pytest smoke tests in AGINTI.md\n/exit\n");
   const updatedInstructions = await fs.readFile(path.join(tempRoot, "AGINTI.md"), "utf8");
   if (!updatedInstructions.includes("pytest smoke tests")) {
@@ -159,7 +163,7 @@ try {
       {
         ok: true,
         projectRoot: tempRoot,
-        checks: ["markdown-render", "markdown-table-no-duplicate", "patch-diff-render", "prompt-layout", "live-input-status-layout", "agent-response-gutter", "aginti-md", "instructions-command", "instructions-chat-edit", "interactive-chat", "mock-file-write", "run-status", "resume-latest", "resume-history-full"],
+        checks: ["markdown-render", "markdown-table-no-duplicate", "patch-diff-render", "prompt-layout", "live-input-status-layout", "agent-response-gutter", "aginti-md", "instructions-command", "skills-command", "instructions-chat-edit", "interactive-chat", "mock-file-write", "run-status", "resume-latest", "resume-history-full"],
       },
       null,
       2

package/scripts/smoke-coding-tools.js

@@ -5,6 +5,7 @@ import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { repairModelMessageHistory, runAgent } from "../src/agent-runner.js";
 import { resolveRuntimeConfig } from "../src/config.js";
+import { readCodebaseMap } from "../src/codebase-map.js";
 import { engineeringGuidanceForTask, recommendedMaxStepsForTask } from "../src/engineering-guidance.js";
 import { selectModelRoute } from "../src/model-routing.js";
 import { listParallelScouts, runParallelScouts, shouldRunParallelScouts } from "../src/parallel-scouts.js";
@@ -219,10 +220,19 @@ try {
   assert(scoutRun.contextPack.includes("package.json"), "parallel scout context pack did not include manifest evidence");
   assert(scoutRun.summary.includes("## shared context pack"), "parallel scout summary omitted shared context pack");
   assert(scoutRun.summary.includes("## coordinator"), "parallel scout summary omitted coordinator synthesis");
+  assert(scoutRun.codebaseMap?.fingerprint, "parallel scout run did not return durable codebase map metadata");
+  assert(scoutRun.blackboard?.lanes?.length === 10, "parallel scout blackboard did not include all scout lanes");
+  assert(scoutRun.blackboard?.coordinator.includes("Swarm Board"), "parallel scout blackboard did not retain coordinator synthesis");
   assert(
     fakeScoutPrompts.filter((prompt) => /Shared context pack:[\s\S]*package\.json/.test(prompt)).length >= 10,
     "parallel scouts did not receive the shared context pack"
   );
+  const codebaseMap = await readCodebaseMap(workspace);
+  assert(codebaseMap.ok && codebaseMap.map.fingerprint === scoutRun.codebaseMap.fingerprint, "durable codebase map was not persisted");
+  const blackboardStore = new SessionStore(runtimeDir, "blackboard-smoke");
+  const blackboardPath = await blackboardStore.saveJsonArtifact("scout-blackboard.json", scoutRun.blackboard);
+  const blackboardJson = JSON.parse(await fs.readFile(blackboardPath, "utf8"));
+  assert(blackboardJson.lanes.length === 10, "scout blackboard artifact did not persist lanes");
 
   const inspectRun = await runMock("Inspect this large codebase and recommend next reads.", "coding-inspect");
   assert(
@@ -368,6 +378,8 @@ try {
           "web_search_dry_run",
           "inspect_project",
           "parallel_scout_context_pack",
+          "durable_codebase_map",
+          "scout_blackboard",
           "mock_inspect_project",
           "write_file",
           "duplicate_write_failed",

package/scripts/smoke-skills.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+import { execFile } from "node:child_process";
+import path from "node:path";
+import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
+import { formatSkillsForPrompt, listSkills, selectSkillsForGoal } from "../src/skill-library.js";
+
+const execFileAsync = promisify(execFile);
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+function assert(condition, message) {
+  if (!condition) throw new Error(message);
+}
+
+function selectedIds(goal, taskProfile = "auto") {
+  return selectSkillsForGoal(goal, { taskProfile, limit: 8 }).map((skill) => skill.id);
+}
+
+const skills = listSkills({ includeBody: true });
+const ids = new Set(skills.map((skill) => skill.id));
+assert(skills.length >= 14, "expected built-in skills to load");
+for (const required of [
+  "aaps",
+  "code",
+  "github-maintenance",
+  "image-generation",
+  "latex-manuscript",
+  "system-maintenance",
+  "website-app",
+  "word-documents",
+]) {
+  assert(ids.has(required), `missing required skill ${required}`);
+}
+
+assert(selectedIds("write a beautiful React website and preview it").includes("website-app"), "website prompt did not select website-app");
+assert(selectedIds("write a LaTeX paper and compile a PDF").includes("latex-manuscript"), "latex prompt did not select latex-manuscript");
+assert(selectedIds("edit a Microsoft Word docx and preserve the original").includes("word-documents"), "docx prompt did not select word-documents");
+assert(selectedIds("generate a logo image with grsai nanobanana").includes("image-generation"), "image prompt did not select image-generation");
+assert(selectedIds("git status commit push with gh").includes("github-maintenance"), "git prompt did not select github-maintenance");
+assert(selectedIds("create an .aaps example for @lazyingart/aaps").includes("aaps"), "AAPS prompt did not select aaps");
+assert(selectedIds("debug a C++ CMake build").includes("c-cpp"), "C++ prompt did not select c-cpp");
+assert(selectedIds("set up Stan and CmdStanR reproducibly").includes("r-stan"), "Stan prompt did not select r-stan");
+
+const prompt = formatSkillsForPrompt(selectSkillsForGoal("write latex manuscript with figures", { taskProfile: "latex", limit: 3 }));
+assert(prompt.includes("A skill is Markdown guidance"), "skill prompt does not explain skill semantics");
+assert(prompt.includes("latex-manuscript"), "skill prompt omitted selected skill");
+assert(prompt.length < 5400, "skill prompt is too large for normal runs");
+
+const cli = await execFileAsync(process.execPath, [path.join(repoRoot, "bin/aginti-cli.js"), "skills", "website"], {
+  cwd: repoRoot,
+  timeout: 10000,
+  maxBuffer: 512 * 1024,
+  env: {
+    ...process.env,
+    AGINTIFLOW_RUNTIME_DIR: "",
+  },
+});
+assert(cli.stdout.includes("website-app"), "aginti skills website did not print website-app");
+
+console.log(
+  JSON.stringify(
+    {
+      ok: true,
+      skills: skills.length,
+      checks: ["load-built-ins", "select-by-goal", "prompt-format", "cli-skills"],
+    },
+    null,
+    2
+  )
+);

package/scripts/smoke-web-api.js

@@ -81,6 +81,9 @@ try {
   if (!Array.isArray(config.taskProfiles) || !config.taskProfiles.some((profile) => profile.id === "latex")) {
     throw new Error("task profiles are not advertised by /api/config");
   }
+  if (!Array.isArray(config.skills) || !config.skills.some((skill) => skill.id === "website-app")) {
+    throw new Error("built-in skills are not advertised by /api/config");
+  }
 
   const keyStatus = await fetchJson("/api/keys/status");
   if (typeof keyStatus.keyStatus?.deepseek !== "boolean") throw new Error("key status endpoint is invalid");

package/skills/aaps/SKILL.md

@@ -0,0 +1,21 @@
+---
+id: aaps
+label: AAPS Workflows
+description: Work with ../AAPS, .aaps files, @lazyingart/aaps, automation plans, and related project conventions.
+triggers:
+  - aaps
+  - .aaps
+  - @lazyingart/aaps
+  - automation plan
+tools:
+  - inspect_project
+  - read_file
+  - write_file
+  - run_command
+  - web_search
+---
+# AAPS Workflows
+
+Inspect nearby `.aaps` files, package docs, and project notes before generating workflows. Keep assumptions explicit and outputs project-local.
+
+Do not publish, upload, or expose credentials unless explicitly requested and safe.

package/skills/android/SKILL.md

@@ -0,0 +1,23 @@
+---
+id: android
+label: Android Development
+description: Build and debug Android, Gradle, Kotlin, Java, emulator, and mobile app projects.
+triggers:
+  - android
+  - gradle
+  - kotlin
+  - java
+  - apk
+  - emulator
+tools:
+  - inspect_project
+  - search_files
+  - apply_patch
+  - run_command
+  - web_search
+---
+# Android Development
+
+Inspect Gradle files, manifests, package names, modules, and existing build scripts before editing. Prefer narrow Gradle tasks and source-set-aware patches.
+
+If SDK/emulator tooling is missing, produce a setup report or project-local script rather than guessing.

package/skills/book-writing/SKILL.md

@@ -0,0 +1,23 @@
+---
+id: book-writing
+label: Book And Long-Form Writing
+description: Plan, draft, revise, and structure books, chapters, scripts, tutorials, and long documents.
+triggers:
+  - book
+  - chapter
+  - script
+  - tutorial
+  - long form
+  - outline
+  - manuscript
+tools:
+  - write_file
+  - read_file
+  - web_search
+  - send_to_canvas
+---
+# Book And Long-Form Writing
+
+Start with structure: audience, promise, outline, chapter flow, voice, and revision plan. Save durable drafts as Markdown unless the user requests another format.
+
+Use web search for current facts and keep source notes when claims matter. For long work, produce incremental chapters and revision notes instead of one huge brittle output.

package/skills/c-cpp/SKILL.md

@@ -0,0 +1,23 @@
+---
+id: c-cpp
+label: C And C++ Development
+description: Work with C, C++, CMake, Make, native builds, tests, and low-level debugging.
+triggers:
+  - c++
+  - cpp
+  - c language
+  - cmake
+  - makefile
+  - gcc
+  - clang
+tools:
+  - inspect_project
+  - search_files
+  - apply_patch
+  - run_command
+---
+# C And C++ Development
+
+Inspect build files before source edits. Keep patches narrow, respect formatting style, and run the smallest compile/test target available.
+
+If native dependencies are missing, prefer Docker/project-local setup notes and do not silently change host toolchains.

package/skills/code/SKILL.md

@@ -0,0 +1,25 @@
+---
+id: code
+label: Code Engineering
+description: Build, edit, debug, test, and maintain software projects across languages.
+triggers:
+  - code
+  - app
+  - bug
+  - test
+  - refactor
+  - package
+  - project
+tools:
+  - inspect_project
+  - search_files
+  - read_file
+  - apply_patch
+  - run_command
+  - web_search
+---
+# Code Engineering
+
+Orient before editing: inspect the project map, read instructions/manifests, search exact symbols or errors, then patch the smallest coherent set of files.
+
+Prefer deterministic `apply_patch` for source edits. Run focused checks first, repair failures, then broaden checks only when useful. Summarize changed files, commands run, and residual risk.

package/skills/github-maintenance/SKILL.md

@@ -0,0 +1,23 @@
+---
+id: github-maintenance
+label: GitHub And Release Maintenance
+description: Use git and gh safely for status, commits, pull requests, releases, and repository maintenance.
+triggers:
+  - git
+  - github
+  - gh
+  - commit
+  - push
+  - pull request
+  - release
+tools:
+  - run_command
+  - read_file
+  - apply_patch
+  - web_search
+---
+# GitHub And Release Maintenance
+
+Always inspect `git status --short` and relevant diffs before committing or pushing. Keep commits scoped and stop on conflicts, divergence, or unrelated dirty work.
+
+Use `gh` for PR/release/status workflows when authenticated. Fold long command output but preserve key errors, URLs, branch names, and commit hashes.

package/skills/image-generation/SKILL.md

@@ -0,0 +1,23 @@
+---
+id: image-generation
+label: Image Generation
+description: Generate or edit raster images, posters, covers, logos, illustrations, and visual assets.
+triggers:
+  - image
+  - logo
+  - poster
+  - cover
+  - illustration
+  - nanobanana
+  - grsai
+  - gpt image
+tools:
+  - generate_image
+  - write_file
+  - send_to_canvas
+---
+# Image Generation
+
+Use image generation when the user asks for a raster visual asset or prompt. Write a concise prompt with subject, style, composition, color, lighting, and output constraints.
+
+Prefer `generate_image` when a GRS AI key is available. Save selected outputs under artifacts and send the chosen image to canvas.

package/skills/latex-manuscript/SKILL.md

@@ -0,0 +1,25 @@
+---
+id: latex-manuscript
+label: LaTeX Manuscript
+description: Write, compile, and package LaTeX papers, reports, figures, bibliographies, and PDFs.
+triggers:
+  - latex
+  - tex
+  - manuscript
+  - paper
+  - pdf
+  - figure
+  - overleaf
+tools:
+  - write_file
+  - apply_patch
+  - run_command
+  - open_workspace_file
+  - send_to_canvas
+  - web_search
+---
+# LaTeX Manuscript
+
+Use a project subfolder with `main.tex`, figures, bibliography, and generated PDFs. Compile from the correct directory with `latexmk` or `pdflatex` when available.
+
+If TeX is missing, produce an honest setup note or Docker-local setup plan instead of faking success. Send the final PDF or source to canvas when useful.

package/skills/novel-writing/SKILL.md

@@ -0,0 +1,21 @@
+---
+id: novel-writing
+label: Novel Writing
+description: Plan, draft, revise, and manage novels, character arcs, scenes, chapters, and long fiction.
+triggers:
+  - novel
+  - fiction
+  - character
+  - scene
+  - plot
+  - chapter
+tools:
+  - write_file
+  - read_file
+  - send_to_canvas
+---
+# Novel Writing
+
+Track premise, characters, setting, conflict, tone, and continuity. Save outlines, chapter drafts, and revision notes as durable files.
+
+For long works, write in scenes or chapters and maintain a compact continuity bible instead of relying on chat history alone.

package/skills/python/SKILL.md

@@ -0,0 +1,24 @@
+---
+id: python
+label: Python Development
+description: Build Python packages, CLIs, scripts, tests, notebooks, plotting, and data workflows.
+triggers:
+  - python
+  - pytest
+  - pyproject
+  - pip
+  - uv
+  - matplotlib
+  - pandas
+tools:
+  - inspect_project
+  - search_files
+  - apply_patch
+  - run_command
+  - send_to_canvas
+---
+# Python Development
+
+Inspect `pyproject.toml`, requirements, package layout, and tests. Prefer stdlib tests when dependency installs are unnecessary; otherwise use project-local venv/conda/uv or Docker.
+
+For plots and artifacts, save files with clear names and send useful outputs to canvas.

package/skills/r-stan/SKILL.md

@@ -0,0 +1,24 @@
+---
+id: r-stan
+label: R And Stan
+description: Work with R, Stan, CmdStan, CmdStanR, PyStan, statistics, and reproducible analysis projects.
+triggers:
+  - r
+  - stan
+  - cmdstan
+  - cmdstanr
+  - pystan
+  - statistics
+  - bayesian
+tools:
+  - inspect_project
+  - write_file
+  - run_command
+  - web_search
+  - send_to_canvas
+---
+# R And Stan
+
+Keep analysis reproducible: scripts, data paths, package notes, seed handling, and output folders. Prefer Docker or project-local toolchains for installation.
+
+For Stan, validate model syntax and compile/run only when toolchains exist; otherwise write honest setup scripts and checks.

package/skills/shell/SKILL.md

@@ -0,0 +1,21 @@
+---
+id: shell
+label: Shell Scripting
+description: Write, audit, and run shell scripts for automation, setup, diagnostics, and maintenance.
+triggers:
+  - shell
+  - bash
+  - script
+  - terminal
+  - command
+  - cli
+tools:
+  - write_file
+  - run_command
+  - web_search
+---
+# Shell Scripting
+
+Prefer idempotent scripts with `set -euo pipefail` when appropriate, clear variables, dry-run or validation modes, and `bash -n` checks.
+
+Separate diagnosis from mutation. Keep dangerous host operations explicit and reversible.

package/skills/system-maintenance/SKILL.md

@@ -0,0 +1,24 @@
+---
+id: system-maintenance
+label: System Maintenance
+description: Diagnose and repair local system, shell, package, Docker, conda, Python, R, and toolchain problems.
+triggers:
+  - system
+  - install
+  - package
+  - docker
+  - conda
+  - environment
+  - fix computer
+  - error
+tools:
+  - run_command
+  - write_file
+  - web_search
+  - send_to_canvas
+---
+# System Maintenance
+
+Diagnose first with read-only commands. Prefer Docker/project-local scripts and `/aginti-env` for broad toolchain setup. Host-level sudo or destructive operations require explicit user approval outside normal automation.
+
+For complicated setup, write idempotent scripts, run syntax checks, and report exact next safe command.