AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

agent-skill-stack

Find, evaluate, and assemble the smallest compatible set of AI Agent Skills for an end-to-end natural-language goal. Use when a user wants Skills for a multi-step workflow, asks which Skills fit a project, needs an installed-Skill audit or conflict check, has low Skill recall, wants indirect helpers such as humanizers or compliance checks, or wants a project-specific Skill Stack with controlled installation. Search local Skills, registries, GitHub, and OpenCLI; compare adoption, verified fit, safety, and overlap. Do not use for locating one known or common Skill; use the generic find-skills workflow.

Original source
github
License
MIT
Pinned revision
5269f7ea2d6c3a9bfda5ed878b6726cf509121fd

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read github--agent-skill-stack at revision 5269f7ea2d6c3a9bfda5ed878b6726cf509121fd, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 5

references/local-index-and-profiles.md

Local index and project Skill Stack Profiles

Why both are needed

Progressive loading and project profiles solve different layers:

  • Progressive loading controls how much of one available Skill enters context: metadata first, full instructions only after a match.
  • Project profile controls which Skills should be considered first for one project and how they hand off.

They are complementary. A profile narrows the candidate set and routing before a match; progressive loading keeps the chosen Skill lightweight afterward.

When the client supports project-local Skill directories, installing to the project is the strongest scope control. A profile file alone expresses routing preferences but cannot force the underlying client to unload globally installed metadata.

Standard local index

The index prevents installed Skills from becoming invisible inventory. Build it from all relevant roots and refresh it after installs, removals, or updates.

Each record contains:

  • stable Skill name and source root;
  • plain-language summary;
  • aliases and capability terms for retrieval;
  • global or project scope;
  • last local modification time;
  • internal Skill-file fingerprint;
  • duplicate or metadata issues.

The index does not execute Skills and stores no prompts, hit rates, or usage history.

Build:

python3 scripts/skill_index.py build \
  --root ~/.codex/skills \
  --root ~/.codex/plugins/cache \
  --root .codex/skills \
  --root ~/.agents/skills \
  --root ~/.hermes/skills \
  --output ~/.codex/skill-index.json

Search:

python3 scripts/skill_index.py search \
  --index ~/.codex/skill-index.json \
  --query "natural Chinese writing" \
  --limit 8

Use the JSON result internally. Present only names, plain summaries, current scope, and recommendation status to a novice.

Project profile

Store the selected stack at <project>/.codex/skill-stack.json.

The profile records:

  • a plain project/profile name;
  • active Skill names;
  • simple intent-to-primary/supporting routes;
  • profile-first behavior;
  • whether searching outside the profile is allowed for uncovered needs.

Create a preview:

python3 scripts/project_profile.py \
  --project /path/to/project \
  --name my-project-stack \
  --skill primary-skill \
  --skill helper-skill \
  --route "main task=primary-skill" \
  --route "writing quality=helper-skill"

Repeat with --apply only after confirmation. Creating a profile does not install a Skill and does not grant new permissions.

Profile routing

When a profile exists:

  1. Match the request against profile routes and active Skills.
  2. Use the profile primary Skill for the main task.
  3. Add a helper only at its defined handoff.
  4. Search outside the profile only when a required capability is missing or the user requests alternatives.
  5. Keep unrelated global Skills out of the proposed stack even if their descriptions are broad.

Rebuild the local index and rerun the recall check after changing a profile.