roles SKILL.md skillA

roles from pipulate/pipulate is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add pipulate/pipulate/roles@git:20260928.8fcdcf8

Pins git:20260928.8fcdcf8 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
pipulate/pipulate
Path
.agents/skills/roles/SKILL.md
Versions recorded
2
Latest version
git:20260928.8fcdcf8, committed Sep 28, 2026
First version recorded
Sep 28, 2026
Size
8,597 bytes
Repository stars
14
License
AGPL-3.0

Explains the Roles plugin, the homepage and APP-menu control center of Pipulate, including which roles show which plugins, the ROLES and EMOJI declarations a plugin must carry, drag-to-reorder, and the Default, Select ALL and Deselect ALL controls. Use when a question concerns the homepage, the APP menu, or why a plugin is missing from it.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Pipulate Roles System: Homepage & Menu Control Center

## Overview: The Heart of Pipulate's UX
The Roles system is Pipulate's **homepage and menu control center** - a sophisticated CRUD application that determines which plugins appear in your APP menu. It's both the **landing page** and the **role-based access control system** that customizes your experience.

## 🎯 **CRITICAL SYSTEM INSIGHT**
The Roles plugin serves **dual purposes**:
1. **Homepage Experience**: First thing users see when they visit Pipulate
2. **Menu Control System**: Determines which plugins appear in the APP dropdown

This dual nature makes it unique - it's both a **workflow management interface** and a **system configuration tool**.

## 🏗️ **How It Works**

### **Automatic Plugin Management**
- **Self-discovering**: New plugins automatically appear in the appropriate roles
- **Always up-to-date**: The system finds and categorizes plugins as they're added
- **Visual appeal**: Each plugin displays with its own unique emoji
- **No manual setup**: Everything works automatically without configuration

### **Built-in Role Types**
The system comes with six predefined roles, each serving different user needs:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add pipulate/pipulate/roles@sha256:390757f9cb618baf

The line at the top of this page pins the label git:20260928.8fcdcf8, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ecqujlj4wb32x6wj.svg)](https://markdownregistry.com/a/art_ecqujlj4wb32x6wj)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, all committed on Sep 28, 2026. Its first recorded version is graded C and its latest A.

versioncommittedcommitsizeaudit
git:20260928.8fcdcf8 latest2026-09-28 8fcdcf8 8,597 BA view · diff
git:20260928.18112272026-09-28 1811227 8,221 BC view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8597 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

pipulate/pipulate · 14 stars · license AGPL-3.0 · pushed 2026-10-21 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ecqujlj4wb32x6wj
GET https://markdownregistry.com/api/v1/resolve?ref=pipulate/pipulate/roles
GET https://markdownregistry.com/api/v1/blob/390757f9cb618bafea1a18fe1a5ed60675ac47a4036c8bd3577bd31c115eb723

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from pipulate/pipulate

gsc-readonly SKILL.md skill
pipulate/pipulate · .agents/skills/gsc-readonly/SKILL.md · Read-only Google Search Console access through connectors/gsc.py. Use when a task needs GSC data compiled into context…
git:20260928.ccf35a8 · audit A · 14 stars
hello-workflow SKILL.md skill
pipulate/pipulate · .agents/skills/hello-workflow/SKILL.md · Explains how a Pipulate workflow turns Jupyter Notebook cells into HTMX steps, from the Step namedtuple and the step_xx…
git:20260928.ccf35a8 · audit A · 14 stars
journal SKILL.md skill
pipulate/pipulate · .agents/skills/journal/SKILL.md · The journal behind Pipulate, indexed. More than a thousand dated articles explain why each piece of the machinery…
git:20260928.2818cd4 · audit A · 14 stars
pipulate SKILL.md skill
pipulate/pipulate · .agents/skills/pipulate/SKILL.md · Installing Pipulate, the local-first context compiler, on a machine that does not have it, without taking the keyboard…
git:20260929.c48a334 · audit C · 14 stars
sheets-readonly SKILL.md skill
pipulate/pipulate · .agents/skills/sheets-readonly/SKILL.md · Read-only Google Sheets access for bounded context pulls. Trigger when a Google Sheets URL or spreadsheet ID needs to…
git:20260928.ccf35a8 · audit A · 14 stars
AGENTS.md AGENTS.md file
pipulate/pipulate · AGENTS.md
git:20260930.6afd9f7 · audit A · 14 stars

Every file in pipulate/pipulate

Other files named roles

roles Cursor rule
sipyourdrink-ltd/bernstein · .cursor/rules/roles.mdc · Agent roles
git:20260521.b455a7c · audit A · 1,310 stars

Browse by kind, by grade A, or by owner.