foundation-evolve

Synchronizes modified skills from a working project to the Foundation repository.

Updated May 21, 2025
One-click install
npx skills add https://github.com/albertmartorell1975/MeteoMartoCompose --skill foundation-evolve-albertmartorell1975
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: foundation-evolve
Source: https://github.com/albertmartorell1975/MeteoMartoCompose/tree/main/.agents/skills/foundation-evolve
Command: npx skills add https://github.com/albertmartorell1975/MeteoMartoCompose --skill foundation-evolve-albertmartorell1975

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping locally developed or modified AI skills in sync with a central Foundation repository requires repetitive manual steps: hashing, copying files, updating manifests and indexes, and committing changes. This Skill automates that entire promotion workflow so updates are never forgotten or inconsistently applied. ## Core Features & Use Cases - Automatic Trigger: Detects any created, modified, or deleted file in the project's .agents/skills/ directory and runs before the agent finishes a task. - Integrity Locking: Updates skills-lock.json with the SHA-256 hash of each promoted skill to guarantee version integrity. - Repository Synchronization: Copies the skill folder to the Foundation repository, updates package.json and the skills README index, then commits and pushes to GitHub. - Use Case: After refining a code-review skill in your Android project, the Skill automatically promotes it to the shared Foundation repo and instructs you to run npx skills update in other projects. ## Quick Start Evolve the foundation with the updated skill from this project.

Frequently Asked Questions about foundation-evolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I sync a modified skill to the Foundation repository?▼

Ask the agent to evolve the foundation with the specific skill name. The Skill copies the folder from .agents/skills, updates skills-lock.json, package.json, and the README index, then commits and pushes to GitHub.

When does the foundation-evolve skill run automatically?▼

It triggers automatically before the agent finishes any task if a file in the working project's .agents/skills directory was created, modified, or deleted. No manual invocation is needed in that case.

Does foundation-evolve add optional plugin skills to package.json?▼

No. Only Core or Guardrail skills are added to the agent-skills.skills object in the Foundation's package.json. Optional plugins are copied to the repository but excluded from the manifest.

How do other projects receive an updated skill?▼

After the Foundation repository is updated and pushed, run npx skills update in each of your other projects. The Skill explicitly instructs the user to perform this step after every promotion.

What is skills-lock.json used for in skill synchronization?▼

skills-lock.json stores the SHA-256 hash of each promoted skill in the working project. It acts as an integrity lock so the exact version of the skill being promoted is recorded and verifiable.