Overriding Project Skills

By default Gisia serves built-in skill files that tell AI bots how to interact with your project. You can replace any of them with your own version by committing Markdown files into a special directory in your repository.

How It Works

When a skill URL is requested, Gisia first looks for a matching file in your repository at:

.gisiabot/skills/<name>.md

If the file exists it is served instead of the built-in default. If it does not exist, the default is used.

The available skill names are:

Step 1 — Create the Directory and File

In your repository, create the directory and add a skill file:

.gisiabot/skills/issues.md

Write your custom instructions in Markdown. You can model the file after the built-in default or write it from scratch to match your team’s workflow.

Step 2 — Commit and Push

git add .gisiabot/skills/issues.md
git commit -m "Override issues skill"
git push

Step 3 — Verify

Fetch the skill URL to confirm your file is being served:

curl https://your-instance/namespace/project/-/issues/skill.md \
  -H "PRIVATE-TOKEN: YOUR_TOKEN"

The response should contain your custom content.