awesome-agents 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 This file is maintained by `npm run changelog` and `npm run release`. Release entries are generated from git commit history.
 
+## 0.1.9 - 2026-07-16
+
+Changes since `v0.1.8`.
+
+### Added
+
+- Add create-agent-profile skill (f5dcfe0)
+
+### Changed
+
+- Expose agent-owned support to installed profiles (#12) (832094e)
+- Name awesome-agents profiles directly (9640910)
+- Remove agents nav link (3ad6bb3)
+- Restore coral site accent (ba2ec5c)
+- Refresh site agent directory (2268134)
+- Make skill dependency resolution fault-tolerant instead of fatal (78aea64)
+
 ## 0.1.8 - 2026-07-08
 
 Changes since `v0.1.6`.

package/README.md

@@ -86,6 +86,11 @@ installs or `~/.awesome-agents/installed.json` for global installs. `list`,
 `remove`, and `update` use this registry and refuse to overwrite or delete files
 that do not contain the generated marker unless `--force` is passed.
 
+Agent-owned references and scripts are installed under
+`~/.agents/homes/<profile>/`. Every installed harness profile receives the exact
+agent-home and support-root paths in its operating context, so profile instructions
+can refer to bundled resources by relative path without becoming harness-specific.
+
 Run Codex profiles with:
 
 ```bash

package/docs/product/profile-source-format.md

@@ -72,6 +72,9 @@ Agent-owned scripts and references should be installed into
 `~/.agents/homes/<profile>/references`.
 Declared skills should be installed into
 `~/.agents/homes/<profile>/skills/<skill>`.
+Installed harness profiles receive the exact agent-home, references, and scripts
+paths in their operating context. Source instructions should refer to these resources
+by relative path instead of embedding a harness-specific or checkout-specific path.
 
 Profile source files are intentionally under `agents/`, not `skills/`, because
 the source format models agent profiles separately from loadable skills.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "awesome-agents",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Install reusable agent profiles into Codex, Claude Code, OpenCode, Goose, and tenex-edge.",
   "type": "module",
   "bin": {

package/src/constants.js

@@ -1,5 +1,5 @@
 export const PACKAGE_NAME = "awesome-agents";
-export const PACKAGE_VERSION = "0.1.8";
+export const PACKAGE_VERSION = "0.1.9";
 export const DEFAULT_AGENT = "codex";
 export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode", "goose", "tenex-edge"];
 export const REGISTRY_DIRNAME = ".awesome-agents";

package/src/installer.js

@@ -36,10 +36,17 @@ export async function installFromSource(sourceSpec, options = {}) {
     const installedAt = new Date().toISOString();
 
     for (const profile of profiles) {
+      const agentHome = resolveAgentHome(profile, options);
       const supportTargets = await installProfileSupport(profile, options);
+      const supportRoots = (profile.supportDirs ?? []).map((supportDir) => ({
+        kind: supportDir.kind,
+        path: path.join(agentHome, supportDir.kind)
+      }));
       const installedSkills = await installProfileSkills(profile, materialized.path, options);
       const renderProfile = {
         ...profile,
+        agentHome,
+        supportRoots,
         installedSkills
       };
       for (const harness of harnesses) {
@@ -63,6 +70,8 @@ export async function installFromSource(sourceSpec, options = {}) {
           target,
           installedAt,
           contentSha256: contentHash(content),
+          agentHome,
+          supportRoots,
           supportTargets,
           skillTargets: installedSkills.map((skill) => skill.path),
           installedSkills,
@@ -253,8 +262,7 @@ async function installProfileSupport(profile, options = {}) {
     return [];
   }
 
-  const home = path.resolve(expandHome(options.home ?? os.homedir()));
-  const agentHome = path.join(home, ".agents", "homes", profile.slug);
+  const agentHome = resolveAgentHome(profile, options);
   const targets = [];
 
   for (const supportDir of profile.supportDirs) {
@@ -273,6 +281,11 @@ async function installProfileSupport(profile, options = {}) {
   return targets;
 }
 
+function resolveAgentHome(profile, options = {}) {
+  const home = path.resolve(expandHome(options.home ?? os.homedir()));
+  return path.join(home, ".agents", "homes", profile.slug);
+}
+
 async function listFilesRecursive(root) {
   const entries = await fs.readdir(root, { withFileTypes: true });
   const files = [];

package/src/renderers.js

@@ -290,9 +290,24 @@ function buildInstructionBody(profile, adapter, harness) {
     `- Installed for: \`${harness}\``,
     "- When asked who you are, what agent is running, or what role you are acting as, answer with this identity and role.",
     "- This profile is a reusable operational agent profile, not a skill or local machine setup.",
-    "- The runtime agent manages any profile-specific home directory and notes at task time."
+    profile.agentHome
+      ? `- Agent home: \`${profile.agentHome}\``
+      : "- This render-only output does not install an agent home or support material."
   ];
 
+  if (profile.supportRoots?.length) {
+    parts.push(
+      "",
+      "## Agent-Owned Support",
+      "",
+      "Use these installed resources when the operating procedure calls for them. Resolve relative support paths against these roots.",
+      ""
+    );
+    for (const support of profile.supportRoots) {
+      parts.push(`- \`${support.kind}\`: \`${support.path}\``);
+    }
+  }
+
   if (profile.installedSkills?.length) {
     const skillBase = path.join(path.dirname(profile.installedSkills[0].path), "<skill>");
     parts.push(

package/src/skills.js

@@ -27,26 +27,38 @@ export async function installProfileSkills(profile, sourceRoot, options = {}) {
   const installed = [];
 
   for (const dependency of dependencies) {
-    const skill = await resolveSkillDependency(profile, dependency, sourceRoot, home, options);
-    const target = path.join(home, ".agents", "homes", profile.slug, "skills", skill.installName);
-
-    if (!options.dryRun) {
-      await fs.rm(target, { recursive: true, force: true });
-      await fs.mkdir(path.dirname(target), { recursive: true });
-      await fs.cp(skill.path, target, {
-        recursive: true,
-        dereference: true,
-        preserveTimestamps: true
-      });
+    let resolved;
+    try {
+      resolved = await resolveSkillDependency(profile, dependency, sourceRoot, home, options);
+    } catch (error) {
+      console.warn(`Skipping skill "${dependency.selector ?? dependency.source}" for profile "${profile.slug}": ${error.message}`);
+      continue;
     }
 
-    installed.push({
-      name: skill.installName,
-      declaredName: dependency.selector ?? dependency.source ?? skill.name,
-      source: skill.source,
-      sourceKind: skill.sourceKind,
-      path: target
-    });
+    const { skill, cleanup } = resolved;
+    try {
+      const target = path.join(home, ".agents", "homes", profile.slug, "skills", skill.installName);
+
+      if (!options.dryRun) {
+        await fs.rm(target, { recursive: true, force: true });
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.cp(skill.path, target, {
+          recursive: true,
+          dereference: true,
+          preserveTimestamps: true
+        });
+      }
+
+      installed.push({
+        name: skill.installName,
+        declaredName: dependency.selector ?? dependency.source ?? skill.name,
+        source: skill.source,
+        sourceKind: skill.sourceKind,
+        path: target
+      });
+    } finally {
+      await cleanup();
+    }
   }
 
   return installed;
@@ -115,6 +127,8 @@ function looksLikeRemoteSource(value) {
   return value.includes("/") || value.includes(":") || value.startsWith("~") || value.startsWith(".");
 }
 
+const NOOP_CLEANUP = async () => {};
+
 async function resolveSkillDependency(profile, dependency, sourceRoot, home, options) {
   if (dependency.source) {
     const materialized = await materializeSource(dependency.source, {
@@ -122,13 +136,15 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
       requireAgentProfileLayout: false
     });
     try {
-      return await selectSkillFromRoot(materialized.path, dependency.selector, {
+      const skill = await selectSkillFromRoot(materialized.path, dependency.selector, {
         dependency,
         source: materialized.source,
         sourceKind: materialized.kind
       });
-    } finally {
+      return { skill, cleanup: materialized.cleanup };
+    } catch (error) {
       await materialized.cleanup();
+      throw error;
     }
   }
 
@@ -138,7 +154,7 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
     sourceKind: "profile-local"
   });
   if (profileSkill) {
-    return profileSkill;
+    return { skill: profileSkill, cleanup: NOOP_CLEANUP };
   }
 
   const sourceSkill = await findSkillInRoot(sourceRoot, dependency.selector, {
@@ -147,7 +163,7 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
     sourceKind: "local-source"
   });
   if (sourceSkill) {
-    return sourceSkill;
+    return { skill: sourceSkill, cleanup: NOOP_CLEANUP };
   }
 
   const userSkillRoot = path.join(home, ".agents", "skills");
@@ -157,7 +173,7 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
     sourceKind: "user-skills"
   });
   if (userSkill) {
-    return userSkill;
+    return { skill: userSkill, cleanup: NOOP_CLEANUP };
   }
 
   throw new Error(`Skill "${dependency.selector}" was not found in the profile source or ${userSkillRoot}.`);
@@ -246,7 +262,13 @@ async function discoverSkills(root) {
       return true;
     }
 
-    const skill = await readSkill(skillDir, root);
+    let skill;
+    try {
+      skill = await readSkill(skillDir, root);
+    } catch (error) {
+      console.warn(`Skipping unreadable skill at ${skillDir}: ${error.message}`);
+      return true;
+    }
     if (seenNames.has(skill.installName)) {
       return true;
     }