@codyswann/lisa 2.36.0 → 2.38.0

package/plugins/lisa-rails/skills/ops-check-logs/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "ops-check-logs"
+short_description: "Check application logs from local Docker Compose or remote AWS CloudWatch for Rails applications. Supports log tailing, filtering, and error searching."
+default_prompt:
+  - "Use $ops-check-logs"

package/plugins/lisa-rails/skills/ops-deploy/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "ops-deploy"
+short_description: "Deploy Rails applications via Kamal or CI/CD branch push to staging or production environments."
+default_prompt:
+  - "Use $ops-deploy"

package/plugins/lisa-rails/skills/ops-run-local/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "ops-run-local"
+short_description: "Manage the local Docker Compose development environment for Rails applications. Supports start, stop, restart, and status for the full stack or individual services."
+default_prompt:
+  - "Use $ops-run-local"

package/plugins/lisa-rails/skills/ops-verify-jobs/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "ops-verify-jobs"
+short_description: "Verify Solid Queue background jobs are running in Rails applications. Check worker health, queue depth, failed jobs, recurring job execution, and retry stuck jobs."
+default_prompt:
+  - "Use $ops-verify-jobs"

package/plugins/lisa-rails/skills/ops-verify-telemetry/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "ops-verify-telemetry"
+short_description: "Verify OpenTelemetry traces are being collected and exported to AWS X-Ray for Rails applications. Check collector health, trace export, and CloudWatch metrics."
+default_prompt:
+  - "Use $ops-verify-telemetry"

package/plugins/lisa-typescript/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.36.0",
+  "version": "2.38.0",
   "description": "TypeScript-specific hooks — Prettier formatting, ESLint linting, and ast-grep scanning on edit",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-typescript/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-typescript",
-  "version": "2.36.0",
+  "version": "2.38.0",
   "description": "TypeScript-specific hooks for formatting, linting, and ast-grep scanning on edit.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.36.0",
+  "version": "2.38.0",
   "description": "LLM Wiki — a distributable, git-native markdown knowledge base for Claude Code and Codex",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lisa-wiki",
-  "version": "2.36.0",
+  "version": "2.38.0",
   "description": "Distributable LLM Wiki kernel — ingest, query, lint, and maintain a git-native markdown knowledge base across Claude and Codex.",
   "author": {
     "name": "Cody Swann"

package/plugins/lisa-wiki/skills/lisa-wiki-add-ingest/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-add-ingest"
+short_description: "Scaffold a project-specific \"front-door\" ingest skill that does something unique (classify a source, fetch from a special system, stamp domain frontmatter) and then chains into /ingest. Use when a project needs a bespoke ingestion path that the core connectors do not cover — instead of forking the kernel. The generated skill enriches and delegates; the kernel still owns synthesis, index, log, verify, state, and PR."
+default_prompt:
+  - "Use $lisa-wiki-add-ingest"

package/plugins/lisa-wiki/skills/lisa-wiki-add-role/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-add-role"
+short_description: "Scaffold a domain-expert \"digital staff\" role over the wiki — a dual-runtime subagent (Claude + Codex) plus a staff doc page — from a config.staff[] entry. Use when a project wants a role-scoped expert (e.g. Legal, Finance, Sales) whose knowledge is a slice of the wiki. The plugin only SETS UP the subagent; whether it is ever invoked, scheduled, or routed is out of scope."
+default_prompt:
+  - "Use $lisa-wiki-add-role"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-confluence/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-confluence"
+short_description: "Produce sanitized Confluence source notes for lisa-wiki ingest via the Atlassian MCP. Use only when lisa-wiki-ingest routes to the confluence connector. Read-only; tenant-guarded."
+default_prompt:
+  - "Use $lisa-wiki-connector-confluence"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-docs/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-docs"
+short_description: "Ingest a local document (PDF, DOCX, Markdown, text) into a sanitized source note for lisa-wiki ingest. Use only when lisa-wiki-ingest routes to the docs connector (a file-path input). Uses available local converters; no heavy bundled dependency."
+default_prompt:
+  - "Use $lisa-wiki-connector-docs"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-git/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-git"
+short_description: "Produce sanitized git/PR-history source notes for lisa-wiki ingest. Use only when lisa-wiki-ingest routes to the git connector (self repo or a registered project). Read-only — never checks out, fetches, or mutates the target repo."
+default_prompt:
+  - "Use $lisa-wiki-connector-git"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-jira/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-jira"
+short_description: "Produce sanitized JIRA source notes for lisa-wiki ingest via the Atlassian MCP. Use only when lisa-wiki-ingest routes to the jira connector. Read-only; tenant-guarded."
+default_prompt:
+  - "Use $lisa-wiki-connector-jira"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-memory/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-memory"
+short_description: "Ingest the agent's PROJECT-SCOPED memory into a sanitized source note. Use only when lisa-wiki-ingest routes to the memory connector. NEVER ingests global or unrelated memory — global Codex memory and the Chronicle store are refused."
+default_prompt:
+  - "Use $lisa-wiki-connector-memory"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-notion/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-notion"
+short_description: "Produce sanitized Notion source notes for lisa-wiki ingest via the Notion MCP. Use only when lisa-wiki-ingest routes to the notion connector. Read-only; teamspace-guarded."
+default_prompt:
+  - "Use $lisa-wiki-connector-notion"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-roles/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-roles"
+short_description: "Ingest the wiki's own digital-staff roster (config.staff[] + wiki/staff/*) into a sanitized source note. Use only when lisa-wiki-ingest routes to the roles connector. Does not run any subagent."
+default_prompt:
+  - "Use $lisa-wiki-connector-roles"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-slack/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-slack"
+short_description: "Ingest a Slack channel into sanitized source notes via a user token. Use only when lisa-wiki-ingest routes to the slack connector AND the run carries explicit external-write intent (Slack OAuth opens a browser and stores a token file). Centralized stdlib-Python scripts; secrets are redacted."
+default_prompt:
+  - "Use $lisa-wiki-connector-slack"

package/plugins/lisa-wiki/skills/lisa-wiki-connector-web/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-connector-web"
+short_description: "Ingest a public URL into a sanitized source note for lisa-wiki ingest (via WebFetch). Use only when lisa-wiki-ingest routes to the web connector (a URL input). Read-only."
+default_prompt:
+  - "Use $lisa-wiki-connector-web"

package/plugins/lisa-wiki/skills/lisa-wiki-doctor/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-doctor"
+short_description: "Verify that a wiki is correctly set up and (after migration) fully functional. Runs the deterministic checks plus functional smoke tests, writes a doctor report, and returns an overall verdict. Use as the final gate of /migrate, after /setup, or anytime to confirm wiki health. A repo is not \"migrated\" until its doctor verdict is READY."
+default_prompt:
+  - "Use $lisa-wiki-doctor"

package/plugins/lisa-wiki/skills/lisa-wiki-ingest/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-ingest"
+short_description: "Ingest source material into the LLM Wiki. With an argument (URL, file path, or prompt) it ingests that one source; with no argument it runs a full ingest across every enabled non-external-write source. Routes to the right connector, then runs the ordered pipeline (source note → synthesis → index → log → verify → state → commit/PR). Use whenever new knowledge should enter the wiki."
+default_prompt:
+  - "Use $lisa-wiki-ingest"

package/plugins/lisa-wiki/skills/lisa-wiki-lint/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-lint"
+short_description: "Health-check the LLM Wiki. Reports orphan pages, contradictions, stale claims, broken internal links, missing index/log coverage, structure-manifest violations, and secret/tenant leaks. Use periodically or before hardening a wiki. Read-only — it reports findings, it does not fix them."
+default_prompt:
+  - "Use $lisa-wiki-lint"

package/plugins/lisa-wiki/skills/lisa-wiki-migrate/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-migrate"
+short_description: "Migrate an existing, hand-rolled wiki implementation onto the lisa-wiki kernel — phased and compatibility-first, with a strict no-loss guarantee. Use when adopting lisa-wiki in a repo that already has its own wiki/, ingest skills, docs, or roles. Renaming things into the canonical shape is fine; losing functionality or data is not. Ends by running /doctor."
+default_prompt:
+  - "Use $lisa-wiki-migrate"

package/plugins/lisa-wiki/skills/lisa-wiki-onboard-me/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-onboard-me"
+short_description: "Onboard a user to the project via its LLM Wiki. Interviews the user about themselves in relation to the project, captures that to project-scoped memory only, then gives a guided tour of what the project is and sample questions they can ask. Use when someone is new to the project or asks to be onboarded. Read-mostly — it does not open PRs or write PII into the wiki."
+default_prompt:
+  - "Use $lisa-wiki-onboard-me"

package/plugins/lisa-wiki/skills/lisa-wiki-query/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-query"
+short_description: "Answer a question from the LLM Wiki with citations. Reads the index, drills into relevant pages, and synthesizes a cited answer. Read-only by default; only files new synthesis back into the wiki when the user explicitly asks. Use when someone asks a question the wiki should be able to answer, or wants to explore what the wiki knows."
+default_prompt:
+  - "Use $lisa-wiki-query"

package/plugins/lisa-wiki/skills/lisa-wiki-setup/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-setup"
+short_description: "Scaffold, repair, verify, or upgrade a project's LLM Wiki from its config. Use when setting up the wiki in a new repo, fixing a broken/incomplete structure, or upgrading to a newer kernel version. Asks the wiki's purpose and README mode, renders the contract snapshot, scaffolds the canonical folders, and seeds the staff roster. Idempotent and non-destructive."
+default_prompt:
+  - "Use $lisa-wiki-setup"

package/plugins/lisa-wiki/skills/lisa-wiki-usage/agents/openai.yaml

@@ -0,0 +1,4 @@
+display_name: "lisa-wiki-usage"
+short_description: "Explain how to browse, query, and contribute to this project's LLM Wiki. Use when a user asks how the wiki works, where knowledge lives, how to find something, or how to add to it — the read/navigation path, not an ingestion or write workflow."
+default_prompt:
+  - "Use $lisa-wiki-usage"

package/scripts/generate-codex-plugin-artifacts.mjs

@@ -69,6 +69,138 @@ export function parseSkillFrontmatter(skillMdPath) {
   return frontmatter;
 }
 
+/**
+ * Encode a single string as a YAML double-quoted scalar.
+ *
+ * Double-quoting unconditionally is the deterministic choice: it round-trips
+ * every possible string — colons, leading `#`/`-`, quotes, indicators — without
+ * the branchy "is this plain-safe?" logic that risks emitting ambiguous YAML.
+ * Only the five escapes YAML's double-quoted style requires are applied, in a
+ * fixed order, so output is a pure function of the input.
+ *
+ * @param {string} value Raw string to encode.
+ * @returns {string} The value wrapped in double quotes with `\`, `"`, and the
+ *   C0 control characters (tab, newline, carriage return) escaped.
+ */
+function yamlQuote(value) {
+  const escaped = value
+    .replace(/\\/g, "\\\\")
+    .replace(/"/g, '\\"')
+    .replace(/\t/g, "\\t")
+    .replace(/\n/g, "\\n")
+    .replace(/\r/g, "\\r");
+  return `"${escaped}"`;
+}
+
+/**
+ * Serialize a Codex `interface` object to deterministic `openai.yaml` content.
+ *
+ * Emits exactly three keys in a fixed order — `display_name`,
+ * `short_description`, then `default_prompt` (a block sequence) — with every
+ * scalar double-quoted and a single trailing newline. The function is pure:
+ * given the same input it returns byte-identical output (no timestamps, no
+ * randomness, no filesystem), which is what keeps `bun run build:plugins`
+ * reproducible and the Plugins Sync CI gate stable.
+ *
+ * @param {{ display_name: string, short_description: string, default_prompt: readonly string[] }} iface
+ *   The normalized interface object. `default_prompt` is always rendered as a
+ *   block sequence (an empty array becomes `default_prompt: []`).
+ * @returns {string} Deterministic YAML, terminated by exactly one newline.
+ */
+export function serializeInterfaceToYaml(iface) {
+  const prompts = iface.default_prompt ?? [];
+  const promptBlock =
+    prompts.length === 0
+      ? "default_prompt: []"
+      : ["default_prompt:", ...prompts.map(p => `  - ${yamlQuote(p)}`)].join(
+          "\n"
+        );
+  const lines = [
+    `display_name: ${yamlQuote(iface.display_name)}`,
+    `short_description: ${yamlQuote(iface.short_description)}`,
+    promptBlock,
+  ];
+  return `${lines.join("\n")}\n`;
+}
+
+/**
+ * Derive a Codex `interface` object from a skill's SKILL.md frontmatter.
+ *
+ * NOTE ON DERIVATION RULES: this is the minimal/placeholder derivation that the
+ * walk-and-emit shell (issue #547) needs to produce a valid `interface` block.
+ * The richer humanization/summarization rules — title-casing `display_name`,
+ * trimming `short_description`, and the `$<name>` starter prompt — are issue
+ * #548's responsibility and will refine these defaults. Until then we fall back
+ * to the raw frontmatter values (and the skill directory name when frontmatter
+ * is missing) so every skill still emits a well-formed file.
+ *
+ * @param {{ name?: string, description?: string } | null} frontmatter Parsed
+ *   SKILL.md frontmatter (or `null` when the file has no frontmatter block).
+ * @param {string} skillName The skill directory name, used as a fallback.
+ * @returns {{ display_name: string, short_description: string, default_prompt: string[] }}
+ *   The normalized interface object the serializer consumes. Pure.
+ */
+export function deriveSkillInterface(frontmatter, skillName) {
+  const name = frontmatter?.name?.trim() || skillName;
+  const description = frontmatter?.description?.trim() || "";
+  return {
+    display_name: name,
+    short_description: description,
+    default_prompt: [`Use $${name}`],
+  };
+}
+
+/**
+ * Walk every `skills/<name>/SKILL.md` in a built plugin and emit a per-skill
+ * `skills/<name>/agents/openai.yaml` (issue #547).
+ *
+ * For each skill directory containing a SKILL.md, the frontmatter is parsed
+ * (#545), an interface object is derived (#548 refines the rules), and the
+ * deterministic serializer (#546) writes `agents/openai.yaml`, creating the
+ * `agents/` directory when missing. Behavior boundaries:
+ *
+ *  - No-op when the plugin has no `skills/` directory.
+ *  - Never clobber a hand-authored `agents/openai.yaml` that already exists in
+ *    source (that is issue #550's surface — but we must not overwrite it here
+ *    regardless).
+ *  - The `commands/` directory is left untouched — Codex does not consume Claude
+ *    `commands/`.
+ *
+ * @param {string} pluginDir Absolute path to a built plugin directory.
+ * @returns {void} Writes files as a side effect.
+ */
+export function writeSkillAgents(pluginDir) {
+  const skillsDir = path.join(pluginDir, "skills");
+  if (!fs.existsSync(skillsDir)) {
+    return;
+  }
+
+  const entries = fs
+    .readdirSync(skillsDir, { withFileTypes: true })
+    .filter(entry => entry.isDirectory())
+    .map(entry => entry.name)
+    .sort();
+
+  for (const skillName of entries) {
+    const skillDir = path.join(skillsDir, skillName);
+    const skillMdPath = path.join(skillDir, "SKILL.md");
+    if (!fs.existsSync(skillMdPath)) {
+      continue;
+    }
+
+    const openaiYamlPath = path.join(skillDir, "agents", "openai.yaml");
+    // Don't clobber a hand-authored openai.yaml carried over from source.
+    if (fs.existsSync(openaiYamlPath)) {
+      continue;
+    }
+
+    const frontmatter = parseSkillFrontmatter(skillMdPath);
+    const iface = deriveSkillInterface(frontmatter, skillName);
+    fs.mkdirSync(path.dirname(openaiYamlPath), { recursive: true });
+    fs.writeFileSync(openaiYamlPath, serializeInterfaceToYaml(iface));
+  }
+}
+
 function main() {
   const [pluginDirArg, versionArg] = process.argv.slice(2);
   if (!pluginDirArg || !versionArg) {
@@ -94,6 +226,7 @@ function main() {
   const pluginName = claudeManifest.name;
 
   writeCodexManifest(pluginDir, claudeManifest, pluginName, versionArg);
+  writeSkillAgents(pluginDir);
 }
 
 function writeCodexManifest(pluginDir, claudeManifest, pluginName, version) {