Skip to content

Desktop app that records your on-screen work session and uses the GitHub Copilot SDK to reconstruct it as an intent + ordered steps, then builds a reusable Skill or Automation for Microsoft Autopilots like Scout, Microsoft Copilot Cowork, or Copilot Studio.

feat: add generic Agent skill export target (#47)

adileifbddf78292a5
diff --git a/common/architecture-registry.test.ts b/common/architecture-registry.test.ts
index bdc31aa..10f7589 100644
--- a/common/architecture-registry.test.ts
+++ b/common/architecture-registry.test.ts
@@ -20,6 +20,7 @@ test("the manifest derives architecture validation and target availability", ()
assert.deepEqual(SkillArchitecture.options, [
"scout",
"cowork",
+ "agent-skill",
"copilot-studio",
]);
assert.equal(SkillArchitecture.safeParse("generic").success, false);
@@ -29,6 +30,7 @@ test("the manifest derives architecture validation and target availability", ()
[
["scout", true],
["cowork", true],
+ ["agent-skill", true],
["copilot-studio", false],
],
);
@@ -46,6 +48,7 @@ test("the manifest derives architecture validation and target availability", ()
["scout", "skill", true, ["install", "export"], "Scout"],
["scout", "automation", true, ["install"], "Scout"],
["cowork", "skill", true, ["export"], "Microsoft 365 Copilot"],
+ ["agent-skill", "skill", true, ["export"], "your agent"],
["copilot-studio", "skill", false, ["export"], "Copilot Studio"],
],
);
@@ -56,7 +59,11 @@ test("the manifest derives architecture validation and target availability", ()
"Scout",
);
- assert.deepEqual(enabledArchitectureLabels("skill"), ["Scout", "Cowork"]);
+ assert.deepEqual(enabledArchitectureLabels("skill"), [
+ "Scout",
+ "Cowork",
+ "Agent skill",
+ ]);
assert.deepEqual(enabledArchitectureLabels("automation"), ["Scout"]);
});
diff --git a/common/architecture-registry.ts b/common/architecture-registry.ts
index 1fae2f4..d856ddb 100644
--- a/common/architecture-registry.ts
+++ b/common/architecture-registry.ts
@@ -118,6 +118,24 @@ export const ARCHITECTURE_MANIFEST = defineArchitectures([
},
],
},
+ {
+ id: "agent-skill",
+ label: "Agent skill",
+ // Export-only, so this label is never surfaced; kept non-blank for the manifest
+ // invariant and as a sensible fallback if the target ever gains an install path.
+ installTargetLabel: "your agent",
+ note: "Any skill-capable agent. Not tuned to specific tools. You verify it can perform the tasks.",
+ targets: [
+ {
+ kind: "skill",
+ label: "Agent skill",
+ enabled: true,
+ note:
+ "Any skill-capable agent. Not tuned to specific tools. You verify it can perform the tasks.",
+ placements: ["export"],
+ },
+ ],
+ },
{
id: "copilot-studio",
label: "Copilot Studio",
diff --git a/electron/architectures/catalogue-registry.test.ts b/electron/architectures/catalogue-registry.test.ts
index ff96871..fd1b3b2 100644
--- a/electron/architectures/catalogue-registry.test.ts
+++ b/electron/architectures/catalogue-registry.test.ts
@@ -11,6 +11,7 @@ import {
defineCatalogueProvider,
providersFromModules,
} from "./catalogue-provider";
+import agentSkillCatalogueProvider from "./catalogues/agent-skill-catalogue";
import coworkCatalogueProvider from "./catalogues/cowork-catalogue";
import scoutCatalogueProvider from "./catalogues/scout-catalogue";
@@ -28,6 +29,11 @@ const coworkProvider = defineCatalogueProvider({
skill: { version: "cowork-skill-v1", content: "Cowork skill catalogue" },
});
+const agentSkillProvider = defineCatalogueProvider({
+ architecture: "agent-skill",
+ skill: { version: "agent-skill-v1", content: "Agent Skill catalogue" },
+});
+
function sha256(content: string): string {
return createHash("sha256").update(content, "utf8").digest("hex");
}
@@ -44,7 +50,11 @@ function providersWithScoutSkill(skill: unknown): readonly unknown[] {
}
test("the registry resolves enabled catalogues and derives unavailable errors", () => {
- const registry = createCatalogueRegistry([scoutProvider, coworkProvider]);
+ const registry = createCatalogueRegistry([
+ scoutProvider,
+ coworkProvider,
+ agentSkillProvider,
+ ]);
assert.deepEqual(registry.catalogueFor("scout", "skill"), scoutProvider.skill);
assert.deepEqual(
@@ -70,13 +80,14 @@ test("disabled targets stay unavailable even when catalogue content is staged",
const registry = createCatalogueRegistry([
scoutProvider,
coworkProvider,
+ agentSkillProvider,
stagedCopilotStudioProvider,
]);
assert.equal(registry.catalogueFor("copilot-studio", "skill"), null);
assert.throws(
() => registry.requireCatalogue("copilot-studio", "skill"),
- /That target architecture isn't available yet\. Choose Scout or Cowork\./,
+ /That target architecture isn't available yet\. Choose Scout, Cowork, or Agent skill\./,
);
});
@@ -166,6 +177,7 @@ test("real providers preserve versions, content, and the support matrix", () =>
const registry = createCatalogueRegistry([
scoutCatalogueProvider,
coworkCatalogueProvider,
+ agentSkillCatalogueProvider,
]);
// These hashes prove catalogue moves are byte-for-byte. Intentional catalogue
@@ -189,4 +201,11 @@ test("real providers preserve versions, content, and the support matrix", () =>
sha256(coworkSkill.content),
"39ffbdf3225ce47eecd735252558cffe860eb6a207782a2f604a8a57fb9a0f68",
);
+
+ const agentSkillSkill = registry.requireCatalogue("agent-skill", "skill");
+ assert.equal(agentSkillSkill.version, "2026-08-06");
+ assert.equal(
+ sha256(agentSkillSkill.content),
+ "27cb863efb3fe973d3b7d4e24359cf5297c1b30fdbc29c073878b57a6d5d8810",
+ );
});
diff --git a/electron/architectures/catalogues/agent-skill-catalogue.ts b/electron/architectures/catalogues/agent-skill-catalogue.ts
new file mode 100644
index 0000000..8d665a5
--- /dev/null
+++ b/electron/architectures/catalogues/agent-skill-catalogue.ts
@@ -0,0 +1,50 @@
+import { defineCatalogueProvider } from "../catalogue-provider";
+
+/**
+ * A **static, versioned** catalogue for a *generic* target: any AI agent that
+ * supports skills. Unlike the Scout and Cowork catalogues, it deliberately lists
+ * NO proprietary built-in tools — a skill built for this target must rely only on
+ * portable capabilities (files, shell/CLIs, documented HTTP APIs) so it can load
+ * into whatever agent the user chooses.
+ */
+export const AGENT_SKILL_CATALOGUE_VERSION = "2026-08-06";
+
+const AGENT_SKILL_CATALOGUE = `
+# Target: Any AI agent with skill support — generic skill catalogue (portable capabilities only)
+
+An **Agent skill** is a portable \`SKILL.md\` file: optional YAML frontmatter followed by a
+markdown **instructions body** (the standard Copilot skill shape). It targets no specific
+host, so it must NOT assume any proprietary built-in tools.
+
+Frontmatter fields:
+- \`name\` — kebab-case, \`^[a-z0-9-]+$\`.
+- \`description\` — one line of trigger keywords (when the agent should reach for this skill).
+- \`allowed-tools\` (optional) — a YAML list of tool patterns the skill may use, e.g.
+ \`Bash(gh *)\`, \`Read\`, \`Write\`, \`Grep\`, \`Glob\`. Omit it to allow the default set.
+
+The body is plain instructions written TO the agent (imperative voice): when to use the
+skill, the procedure to follow, and how to handle inputs and edge cases.
+
+## Assume only portable capabilities
+
+- Do NOT assume host-specific integrations — no Teams / Outlook / Calendar / WorkIQ, and no
+ browser automation. Rely only on capabilities every agent can reasonably provide: reading
+ and writing files, running shell commands and standard CLIs, and calling documented HTTP APIs.
+- Map each recorded UI action to a portable tool, an API call, or a CLI — never write
+ "click" / "type" UI steps.
+
+## Writing the SKILL.md body
+
+- Write a GENERALIZED procedure: if the recording acted on N specific items, the body loops
+ over ALL items of that kind, not the specific examples that were recorded.
+- Resolve each input via the plan (a fixed value / the user provides it / the agent locates it).
+- Keep it concise and imperative. Include a short "When to use" and the ordered steps.
+`.trim();
+
+export default defineCatalogueProvider({
+ architecture: "agent-skill",
+ skill: {
+ version: AGENT_SKILL_CATALOGUE_VERSION,
+ content: AGENT_SKILL_CATALOGUE,
+ },
+});