CtrlK
BlogDocsLog inGet started
Tessl Logo

project-setup

Add a GitHub repository as a tracked project — creates workspace entity, installs workflow automation missions, and includes in dev brief scope.

64

Quality

77%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/project-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Project Setup

Add a new GitHub repository as a tracked project in the workspace and install workflow automation.

Step 1: Parse the repo

Extract owner/repo from the user's message. If ambiguous, ask. Validate via GitHub API: http(method="GET", url="https://api.github.com/repos/{owner}/{repo}"). If 404 or no access, tell the user.

Step 2: Quick setup (3 questions, no timezone)

  1. Who are the maintainers/reviewers? (default: the user's GitHub handle)
  2. Do you use a staging branch? What's it called? (default: no staging; use staging if yes)
  3. Any AI agents creating PRs? (e.g. Dependabot, Copilot, internal bots) (default: none)

Read main_branch from the API response's default_branch field.

Step 3: Create project in workspace

Write projects/<owner>-<repo>/project.md:

---
type: project
repo: <owner/repo>
added_at: <today YYYY-MM-DD>
maintainers: [<handles>]
main_branch: <branch from API>
staging_branch: <branch or null>
ai_agent_authors: [<bot handles>]
workflow_installed: false
---
# <owner/repo>
<description from API response>

## Workflow missions
(populated after install)

Write projects/<owner>-<repo>/notes.md:

# Notes: <owner/repo>
Developer notes for this project. Searchable via memory_search.

Step 4: Install workflow missions

Follow the github-workflow skill's install procedure. For each of the 6 mission templates in github-workflow/references/workflow-routines.md:

  1. Replace {{repository}} with owner/repo
  2. Replace {{slug}} with <owner>-<repo>
  3. Replace {{maintainers}} with the maintainer list
  4. Replace {{main_branch}} and {{staging_branch}} with the configured branches
  5. Replace {{batch_interval_hours}} with 8 (default)
  6. Call mission_create(name, goal, cadence) for each

If staging_branch is null, skip wf-staging-review-<slug>.

After installing, update the project file:

  • Set workflow_installed: true
  • List the installed mission names under ## Workflow missions

Step 5: Confirm

Added <owner/repo> as a tracked project:
- Project file: projects/<owner>-<repo>/project.md
- Workflow missions installed: <list>
- Maintainers: <list>
- Main branch: <branch>, Staging: <branch or "none">
- This repo is now included in your morning brief and triage scans

Say "add repo <another/repo>" to add more, or "remove repo <owner/repo>" to uninstall.
Repository
nearai/ironclaw
Last updated
First committed

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.