Overview
Skills.md files define the capabilities and instructions for custom skills in TeamAI. These files are components within a .skill package that you upload to your workspace. This guide focuses specifically on adding skills.md files to your TeamAI environment.
Learning Objectives:
Understand the role of skills.md within a skill package
Add a skills.md file by uploading a complete .skill package
Verify your skills.md file is properly loaded and accessible
Prerequisites
You'll Need:
Active workspace membership
A
.skillfile that contains your skills.md file (created via skill-creator or manually)Appropriate permissions to upload to your target workspace (personal or shared)
Understanding Skills.md Files
What Is a Skills.md File?
A skills.md file is a component within a TeamAI .skill package that contains:
The skill's name and description
Detailed instructions for how the skill should operate
Input/output specifications
Stylistic requirements and formatting rules
Important: You cannot upload a skills.md file individually.
It must be part of a complete .skill package which includes SKILL.md, references/, assets/, and scripts/ directories.
Adding a Skills.md File via Skill Upload
Since skills.md files are embedded within .skill packages, you add them to TeamAI by uploading the entire package.
Step 1: Obtain Your .skill File
Your skills.md file should be contained within a .skill file (which is actually a zip archive). You can obtain this by:
Using skill-creator: Generate a custom skill which creates a complete
.skillpackage
Manual creation: Package your skills.md file with required SKILL.md, references/, assets/, and scripts/ directories
File transfer: Receive a
.skillfile from a colleague
Note: Ensure your .skill file contains your skills.md in the correct structure before uploading.
Step 2: Navigate to the Skills Upload Interface
Locate the Skills section in the left panel
Click the "Skills" option
The Skills interface loads in the main panel
Click the "Upload Skill" button
Located at the top-right of the Skills interface
A file selection dialog window appears
Step 3: Upload the .skill Package
Select your .skill file from your local machineBrowse to locate the file
Verify the file extension is
.skill
Choose the target workspace
Personal workspace: Skills with sensitive configurations or in development
Shared workspace: Skills for team collaboration and production use
Click "Upload" or "Confirm"
Result: The custom skill containing your skills.md file is successfully uploaded and available in the selected workspace.
Step 4: Verify Your Skills.md File Is Accessible
Open any chat in the workspace where you uploaded the skill
Type / (forward slash) in the chat input fieldThe skills menu displays
Locate your skill by name
The skill name and description (from skills.md) appears in the menu
Select your skill
The skill activates and displays any custom prompts or instructions defined in skills.md
Result: Your skills.md file is successfully loaded and operational within TeamAI.
Best Practices for Skills.md Files
Version Control: Keep local copies of your skills.md files to track changes and enable rollbacks
Clear Descriptions: Write concise but comprehensive descriptions in skills.md so users understand the skill's purpose
Test Before Sharing: Upload skills.md files to a personal workspace first, test thoroughly, then upload to shared workspaces
Consistent Naming: Use descriptive skill names that reflect the skills.md content for easy identification
Documentation: Include comments or documentation within skills.md for complex logic or special requirements
Common Questions
Q: How do I add a skills.md file?
A: You cannot upload a skills.md file by itself. TeamAI only accepts complete .skill packages that contain the skills.md file along with other required components (SKILL.md, references/, assets/, and scripts/ folders).
To add a skills.md file, follow the steps in the Adding a Skills.md File via Skill Upload section above.
Q: How do I know if my skills.md file is properly formatted?
A: TeamAI validates the .skill package during upload. If the upload succeeds, your skills.md file is properly structured. If you receive an error, check that:
Your
.skillfile includes all required components (SKILL.md, references/, assets/, and scripts/ folders).The skills.md file follows the expected markdown structure
File paths within the package are correct
Q: Can I view or edit the skills.md file after uploading?
A: You cannot view or edit the skills.md file directly within TeamAI. To make changes:
Download the original
.skillfile (if available)Extract and edit the skills.md file
Repackage and re-upload the complete
.skillpackage
Q: What's the difference between SKILL.md and skills.md?
A: Both files serve different purposes within a skill package:
SKILL.md: Contains metadata, skill name, description, and configuration
skills.md: Contains the detailed instructions, logic, and operational guidelines for the skill
Both are required for a functional skill package.
Q: How many skills.md files can I have in one .skill package?
A: A standard .skill package contains one skills.md file. If you need multiple instruction sets, consider creating separate skill packages or using conditional logic within a single skills.md file.
Q: Can I share a skills.md file with a colleague?
A: Yes, by sharing the complete .skill package. You cannot share just the skills.md file alone as it depends on the full package structure. Your colleague can then upload it to their workspace.