littlebearappslittlebearapps/pitchdocs/.claude/skills/platform-profiles/SKILL.md

platform-profiles

Skill8 starsChanged 8 months agoMITView on GitHub

Platform-specific equivalents for GitLab and Bitbucket when generating repository documentation. Lookup tables for file paths, badges, Markdown rendering, CI/CD, and CLI tools. Load this skill when working on non-GitHub repos or generating cross-platform docs.

In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .github/copilot-instructions.mdCopilot instructions
- llms-full.txtllms.txt
- llms.txtllms.txt
- api-referenceSkill
- changelogSkill
- doc-refreshSkill
- docs-verifySkill
- feature-benefitsSkill
- geo-optimisationSkill
- launch-artifactsSkill
- llms-txtSkill
- package-registrySkill
- pitchdocs-suiteSkill
- public-readmeSkill
- roadmapSkill
- user-guidesSkill
- visual-standardsSkill
- pitchdocsSkill

The file

Create a free account to mount

Files

SKILL.md

Platform Profiles

PitchDocs defaults to GitHub conventions. Load this skill when the target repository is hosted on GitLab or Bitbucket, or when generating docs that must work across platforms.

Platform Detection

[ -f ".gitlab-ci.yml" ] && PLATFORM="gitlab"
[ -f "bitbucket-pipelines.yml" ] && PLATFORM="bitbucket"
[ -d ".github" ] && PLATFORM="github"
PLATFORM=${PLATFORM:-$(git remote get-url origin 2>/dev/null | grep -oE '(github|gitlab|bitbucket)' | head -1)}

Markdown Rendering Compatibility

Feature	GitHub	GitLab	Bitbucket
`> [!NOTE]` callouts	Yes	Yes	No — use `Note:` bold inline
`<p align="center">`	Yes	Yes	Limited
`<picture>` dark mode	Yes	Yes	No — use single high-contrast image
`<details>`/`<summary>`	Yes	Yes	Limited
Mermaid diagrams	Yes	Yes (+ PlantUML)	No — use pre-rendered SVG
Task lists `- [ ]`	Yes	Yes	No — renders as plain text
Auto TOC	No (manual)	`[[_TOC_]]`	No (manual)
Heading anchor format	`#slug-format`	`#slug-format`	`#markdown-header-slug-format`
Nested list indentation	2 spaces	2 spaces	4 spaces
HTML permissiveness	Moderate (strips `style`)	More permissive	Restrictive

Quick Reference

GitLab: Encode / as %2F in shields.io paths. Self-hosted instances need ?gitlab_url= parameter.
Bitbucket: No <picture>, no Mermaid, no task lists, use 4-space nested indentation, prefix heading anchors with markdown-header-.
MCP tools: mcp__github__* are GitHub-specific. For GitLab/Bitbucket, use glab CLI, REST API, or git history.

For full lookup tables (template directory mapping, badge URLs, CLI tools, CI/CD, feature availability, raw file URLs, compare URLs, Bitbucket degradation), load SKILL-tables.md from this skill directory.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

It worked
Partly
It didn't

What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free