7Factor Skills

Shared agent skills maintained by 7Factor Software.

This repository is a catalog for company-maintained skills. Skills live in the skills/ directory. Each skill is a directory with a SKILL.md file that describes when the skill should be loaded and how the agent should behave.

Available Skills

• mentor: switches an agent into learning-first mentoring mode for developing engineers.

Install

The recommended installer is the Skills CLI documented at skills.sh.

Install a skill from this repository:

npx skills add 7Factor/skills --skill <skill-name>

For example:

npx skills add 7Factor/skills --skill mentor

Install a skill globally for Codex:

npx skills add 7Factor/skills --skill <skill-name> --agent codex --global

During local development from this checkout:

npx skills add . --skill <skill-name>

The CLI can target different agents and scopes. Check the current options with:

npx skills add --help

To opt out of Skills CLI telemetry:

DISABLE_TELEMETRY=1 npx skills add 7Factor/skills --skill <skill-name>

Use

Invoke installed skills by asking the agent for the relevant behavior. The exact phrasing depends on the skill.

For example, after installing mentor:

Use mentor mode while helping me debug this issue.

Contributing

When adding or changing a skill:

1. Use the repo-local write-a-skill skill in .agents/skills/write-a-skill to guide the structure and review checklist.
2. Keep the skill name short and specific.
3. Put the main instructions in skills/<skill-name>/SKILL.md.
4. Keep SKILL.md concise enough for an agent to load quickly.
5. Move lengthy examples or reference material into adjacent files only when needed.
6. Verify the frontmatter includes a clear name and trigger-focused description.