Skip to main content
You’re viewing developer documentation
This documentation is for developers working with the Base44 developer platform. For information about adding skills to agents in the app editor, see Setting up an AI agent.
Agent skills are reusable instruction sets that give your AI agents specific behaviors, expertise, or policies, such as a refund policy or a brand voice. Agent skills are app scoped, so you define them once for your app, then attach any of them to any agent in that app.
These are skills for the agents running inside your app, not the Base44 skills that teach AI coding assistants like Claude and Cursor how to build Base44 apps.

​
How agents use skills

Each agent selects the skills it needs by name. At runtime, the agent always sees each selected skill’s description, and it loads the full instructions on demand only when it decides the skill is relevant. This keeps the agent’s prompt small while giving it access to detailed instructions when needed. You can attach up to 10 skills to a single agent, and an app can hold up to 100 skills in total. To attach a skill to an agent, add the skill’s name to the agent’s selected_skill_names array:

​
Defining agent skills locally

Each skill is a single Markdown file in your base44/agent-skills/ directory. The filename, without the .md extension, is the skill name. The YAML frontmatter holds the skill’s description, and the body holds the instructions the agent follows when it uses the skill. For example:
Skill names must be lowercase and use hyphens to separate words, for example refund-policy. Descriptions can be up to 1024 characters, and instruction bodies up to 15000 characters.
By default, skills live in base44/agent-skills/. You can customize the path with agentSkillsDir in your project configuration.

​
Deploy agent skills

Deploy agent skills with agent-skills push or deploy to push all project resources at once. To download agent skills to your local project, use agent-skills pull.

​
See also