Update a Skill
Skills are reusable tool definitions that tell Mansa’s agents what external actions they can take. Examples include sending emails, downloading attachments, and retrieving Google Slides decks. Each skill is a versioned file bundle uploaded to the Claude Console. Uploading a new version never deletes the old one; prior versions are preserved and visible in the skill’s history.
Skills in the Mansa System
Section titled “Skills in the Mansa System”| Skill | What It Does |
|---|---|
email-actions |
Read emails, list inbox, mark as read, label as processed |
admin-email-actions |
Create reply drafts, run search queries |
draft-email |
Create a reply draft for a specific message |
send-email |
Send an email from the shared inbox |
retrieve-google-slides-deck |
Fetch and extract text from a Google Slides pitch deck |
download-attachment |
Download an email attachment (e.g. a PDF pitch deck) |
analytics-db |
Check if an email has already been processed and log run results to Azure SQL |
When to Update a Skill
Section titled “When to Update a Skill”- The BKR Capital Email API adds a new endpoint or changes an existing one
- You need to adjust how a tool handles a specific input
- A new capability needs to be exposed to agents
How to Update a Skill
Section titled “How to Update a Skill”Step 1: Edit the Skill Files in SharePoint
Section titled “Step 1: Edit the Skill Files in SharePoint”All skill source files live in the Mansa Skills SharePoint folder. Always edit files there first. SharePoint provides audit logging so you have a record of what changed and when.
Each skill is a folder of Markdown files. Open the folder for the skill you want to change and edit the relevant .md files directly in SharePoint or by downloading, editing locally, and re-uploading.
Step 2: Download the Skill Folder as a Zip
Section titled “Step 2: Download the Skill Folder as a Zip”Once your edits are saved in SharePoint, download the entire skill folder as a .zip file:
- Select the skill folder in SharePoint
- Click Download. SharePoint will package it as a
.zip
Step 3: Open the Claude Console
Section titled “Step 3: Open the Claude Console”Go to platform.claude.com/dashboard and sign in.
In the left sidebar, expand Build and click Skills.
Step 4: Find the Skill and Open the Update Dialog
Section titled “Step 4: Find the Skill and Open the Update Dialog”In the skills list, find the skill you want to update and click on its row to open the detail panel.
Click the ⋮ (three-dot menu) in the top-right corner of the panel and select Update.
Step 5: Upload the Zip File
Section titled “Step 5: Upload the Zip File”Drag and drop the .zip file you downloaded from SharePoint into the upload area, or click to browse for it.
The console accepts .zip, .skill, or a directory. Maximum file size is 8 MB.
Step 6: Confirm the New Version
Section titled “Step 6: Confirm the New Version”After uploading, the Claude Console creates a new version automatically. The version number is generated for you. The previous version remains in the skill’s history.
The updated skill takes effect on the next agent run.
Rollback
Section titled “Rollback”If the new skill version causes problems, contact Adullam Technologies to revert to a previous version via the Claude Console API.