Let an AI Agent Operate This Project
From "let the agent read the project" to "one skill set in every agent" โ three levels, shallow to deep
This project ships an AGENTS.md written for AI coding assistants: read that one document and an agent can install the project, generate videos and work out why a run failed. Want to skip the learning step? Install the companion skill set. Switching between agents? There is a third level.
Three levels
Level 1: point your agent at this repository
The repo ships AGENTS.md with the environment requirements, the four-layer deployment checklist and the shared conventions (log prefixes, retry model, i18n rules). Clone it, then give your agent the sentence below.
> Read the AGENTS.md in this project, install dependencies, configure the API key, and start the server.
> Run the deployment verification checks.Limitation: AGENTS.md lives in the repository, so the agent must be able to read it โ and it covers changing the project as much as operating it.
Level 2: install the companion skill set
The skill set packages everyday operations into three ready-made skills, so the agent does not have to work the project out first. They are documentation and small scripts only โ no service code, and no credentials pass through them.
The three skills
- โUsage: deploy, pick a mode, submit and watch a task, edit artifacts at Manual Mode checkpoints
- โTroubleshoot: find out why a run failed, and whether it is worth fixing
- โContrib: change the code and get the PR through CI
Recommended: install with flint
flint is a local-first, open-source skills manager: keep your skills in one place, register them once and deploy them into any agent or project directory. It reads local sources only and never clones for you, so the source you register is the directory cloned above. Open source and free - a star is welcome.
git clone https://github.com/lcy362/agnes-video-generator-skills.git
npx flint-skills-hub # Sources โ add the cloned directory (flint reads its skills/ subdirectory)Or: copy it in by hand (no flint)
cp -R agnes-video-generator-skills/skills/* <project>/.agents/skills/The same skills are just plain directories - copy them into a project .agents/skills/ (any agent that reads that directory works). The trade-off: repeat it for every project and every new agent.
Once installed, ask for outcomes
- ยท My task failed โ find out why and tell me if it is worth fixing.
- ยท The creative video came out silent. I want narration and subtitles โ set it up and run it.
- ยท Take my finished task, improve the storyboard prompts, then regenerate only what is affected.
Level 3: one skill set, every agent
If you switch between agents, register the skill repository in flint, a local-first skills manager: it symlinks or copies the skills into every agent and project directory you use. Everything runs locally โ no cloud, no account, no telemetry.
Flint โWhere an agent helps most: Manual Mode
Manual Mode pauses the pipeline at a checkpoint: the agent reads the artifact manifest, edits the file in place, previews which downstream steps will re-run, then approves. "Polish the narration" becomes one request.
Manual Mode guide โHow the three differ
- AGENTS.md โ for changing this projectโs code
- The companion skill set โ for operating this project
- This page โ the authoritative summary referenced by the website
Get started
No agent required either: the Web Studio needs no install, and the self-hosted version is the most capable.
Related Pages
Agnes Self-Hosting Guide โ Docker, npm, AI Agent | Free AI Video Guide
Run the free open-source AI video generator on your own computer or server: start.sh manual deployment, one-command Docker, npm CLI, AI Agent โ complete commands and requirements.
Manual Mode Guide โ Auto vs Manual: Vibe Generating or Precise Output | Agnes Video
How to use Manual Mode in Agnes Video Generator: pause at checkpoints (storyboard, references, video clips, narration, subtitles, final) to review or refine each artifact before continuing, optionally pairing with stronger external AI or tools for a precise, predictable result. Auto Mode fits vibe video generating from a rough idea; Manual Mode fits clearly specified outputs with fine-tuned artifacts.
Release Notes โ Agnes Video Generator
Full changelog for Agnes Video Generator: new features, improvements, bug fixes and deployment notes, covering the complete version history since v1.0.
Documentation Behind the Agent Levels
The three agent levels described here (read AGENTS.md / install the companion skill set / distribute with flint) and their commands follow the official implementations of the companion skill repository and flint.
- agnes-video-generator โ ๅผๆบ AI ่ง้ข็ๆ้กน็ฎlcy362 ยท GitHub (2026)
AGENTS.md, the four-layer deployment checklist and the agent-operations document under docs/public follow this project's repository.
- agnes-video-generator-skills โ ้กน็ฎไผด้ๆ่ฝๅบ๏ผไฝฟ็จ / ๆ้ / ่ดก็ฎ๏ผlcy362 ยท GitHub (2026)
The three skills (usage / troubleshoot / contrib), their coverage and bundled scripts follow the companion skill repository.
- Flint โ ๆฌๅฐไผๅ
็ไธชไบบ AI ๆ่ฝ็ฎก็ๅจ๏ผskills manager๏ผไธๆ่ฝไธญๆขlcy362 ยท GitHub (2026)
Registering external sources and symlink/copy distribution into agent and project directories, plus the local-first design, follow the flint repository.
Why you can trust this
Written by a practicing developer and cross-checked against authoritative primary sources such as arXiv papers, vendor technical reports, and the Stanford AI Index.
SandGrid@lcy362
Author of Agnes Video Generator ยท Full-stack Developer
Independent developer and author of Agnes Video Generator, an open-source (MIT) AI video generation tool built on Agnes AI's free video models. Has helped 1,000+ creators produce AI videos at zero cost. Focused on making video generation models accessible and production-ready; content is based on hands-on practice and primary research.
View on GitHubLast updated๏ผ2026-08-21
Ready to Start Creating?
"Making world-class AI belong to everyone." โ Bruce Yang. It's completely free, no credit card, and you won't need a high-end GPU. Your first AI video starts at zero cost. Want to use Agnes AI's free video models? This is the easiest way in.
Clone the GitHub repo and launch in 2 minutes