GitLab Agent Profile
Maintain the GitLab agent profile page and static contribution performance chart.
GitLab Agent Profile Skill
Use this skill to keep the GitLab Agent profile assets current with monthly contribution performance statistics.
Your profile's location is https://<gitlab-instance>/<gitlab-username>/<gitlab-username>.git.
Goal
Maintain static profile assets for the agent with:
- Static SVG and WebP chart files showing the last 12 completed calendar months of merged merge requests, owner direct commits to each project's default branch, and contribution score.
- Categories for owner-authored work, agent-authored work with owner review/merge, agent-authored work without owner review/merge, and the combined total.
- A legend and bar labels with the exact counts behind the chart.
- A JSON proof file with public counted records sorted by date descending and anonymized monthly totals for private/internal activity.
Scheduled update routine
Run on the second and third day of each month at 09:00 in Europe/Berlin.
The second run refreshes the completed-month totals after late-arriving activity.
- Check GitLab auth works
- In the canonical profile repository, run
openclaw gitlab-profile --workspace "$PWD". The installedgitlab-agentplugin provides the Node.js collector and publisher; the legacy Python scripts are retained only as regression references. - Verify the completed-month range, project coverage, and monthly counts/scores against the public records plus private monthly totals. API errors must leave the previous assets unpublished.
- Commit and push the assets in the
assets/folder, if they changed.
Inputs
The gitlab-profile command accepts these environment variables. It requires the installed gitlab-agent plugin, Node.js and authenticated glab. WebP rendering uses ImageMagick (magick or convert), or the existing npm sharp-cli fallback. A renderer or API failure leaves previous assets unchanged before publication; never commit after a failed command.
GITLAB_AGENT_PROFILE_CHART_OUTPUT: Static SVG chart file to update. Defaults toassets/gitlab-agent-profile.svg.GITLAB_AGENT_PROFILE_WEBP_OUTPUT: Static WebP chart file to update. Defaults toassets/gitlab-agent-profile.webp.GITLAB_AGENT_PROFILE_RECORDS_OUTPUT: JSON proof file to update. Defaults toassets/gitlab-agent-profile-records.json.GITLAB_AGENT_PROFILE_WORKSPACE: Workspace root used for relative output paths. Defaults to the current directory.GITLAB_AGENT_PROFILE_ROOT_GROUP: Group path to discover recursively, also used to expand short project names. Defaults toxrow-public.GITLAB_AGENT_PROFILE_PROJECTS: Optional space, comma, or newline separated project paths or names. When unset or blank, discover all accessible projects owned by the root group and its subgroups, including archived projects. Exclude projects merely shared into the group. A nonempty value overrides discovery.GITLAB_AGENT_PROFILE_AGENT_USERNAME: Agent username. Defaults to the authenticatedglabuser.GITLAB_AGENT_PROFILE_OWNER_USERNAME: Owner username. Defaults toxrow.GITLAB_AGENT_PROFILE_MONTHS: Positive number of completed calendar months to render. Defaults to12; always exclude the current in-progress month, using completed UTC calendar months.
Relative output values are resolved from GITLAB_AGENT_PROFILE_WORKSPACE.
Project names without / are expanded with GITLAB_AGENT_PROFILE_ROOT_GROUP, so ci-tools becomes xrow-public/ci-tools.
The proof file records project coverage and the completed-month period. Private/internal project names, titles, URLs, commit IDs, and reviewer details stay out of public output; their contributions are grouped by month, kind, and category in private_monthly_totals. Totals and contribution scores include both public and private activity. Empty repositories and disabled repository/MR features are reported in coverage. Other API or metadata failures stop collection rather than publishing partial totals.
Classification
For merged merge requests:
- Owner: author username matches
GITLAB_AGENT_PROFILE_OWNER_USERNAME. - Agent + reviewer: author username matches
GITLAB_AGENT_PROFILE_AGENT_USERNAMEand the owner is a reviewer or merge user. - Agent (autonomous): author username matches
GITLAB_AGENT_PROFILE_AGENT_USERNAMEand the owner is neither reviewer nor merge user. - Merged total: sum of the three MR categories.
- Direct owner commits: commits on each project's default branch authored or committed by the owner that are not known MR merge/squash commits and do not start with
skip:,skip(...),chore:,chore(...),docs:,docs(...), orrevert. - MRs with
type::bugortype::featurelabels count toward MR totals and contribution score. - If a merged MR has no type label, a Conventional Commit title beginning with
fix:/fix(...)orfeat:/feat(...)is used as a fallback type. - MRs beginning with
skip:,skip(...),chore:,chore(...),docs:, ordocs(...)are never counted, even if they have a counted type label. - MR contribution score: each counted MR starts at
1point and is multiplied by its size factor. - Size factor:
size::small=1,size::medium=2,size::large=3,size::xlarge=5; missing size labels default to1. - Direct owner commits count
0.2point each.
The script ignores merge requests authored by other users. The legacy direct_owner_main JSON field and owner_direct_main category now represent direct commits on the project's default branch.
Generate and inspect assets
From the canonical agent profile repository:
openclaw gitlab-profile --workspace "$PWD" --group xrow-public --owner xrow
git diff --stat -- assets/
A successful command writes SVG, WebP and public proof JSON under assets/.
Read the proof coverage and completed-month range before committing changes.
Private project details remain only in authenticated statistics; public assets
contain anonymized private monthly totals. Direct commit identity now requires
an exact GitLab API email match, not a display-name match.
To export a completed Node.js snapshot without collecting again, add
--snapshot /absolute/private/report-directory. This reads the snapshot without
changing it or invoking GitLab collection. Its saved scope and period remain
authoritative; collection options do not filter a snapshot. Do not publish
profile-reports.json.
Each destination replacement is atomic, but a filesystem failure during final
replacement can leave mixed local generations. Review all three outputs and
commit only after a successful command. Concurrent writers fail closed.
The plugin's npm test covers the production Node.js collector, public writer,
explicit overrides, private redaction, cancellation and previous-asset retention.
The retained Python tests are a migration reference, not the scheduled caller.
Bootstrap
List automations including disabled jobs before adding one. Reuse the job with
declaration key profile:gitlab-agent-profile or the matching skill prompt. Never
add a duplicate or change an existing job's enabled state during bootstrap. The
Helm profile automation service already creates this job on a clean install.
- Add this cron, if it existed and was enabled then leave it enabled.
The bundled automation declaration is {baseDir}/AUTOMATIONS.json. Read it before
creating or comparing the scheduled job; it is the source of truth for the
schedule, payload, and delivery.
- Downloads
- 7.7kAll time
- Security audit
- Review
- Last updated
- 7h ago
- Current version
- v1.150.1
- License
- MIT-0
