Piclist Upload
cat-xierluo/legal-skills
通过 PicList HTTP Server 将 Markdown 文件中的本地图片上传到图床，并替换为云端链接。本技能应在用户需要上传 Markdown 中的图片、处理包含本地图片引用的 Markdown、批量处理多个 Markdown 文件或目录、或替换本地路径为云端链接以实现跨设备访问时使用。
Reference mapping between Oh My Posh Go segment source code and MDX documentation.
Install Segment Docs
$ npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install JanDeDobbeleer/oh-my-posh segment-docs --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/segment-docs .claude/skills/segment-docs && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "segment-docs" agent skill from https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docs into .claude/skills/segment-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "segment-docs", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install JanDeDobbeleer/oh-my-posh segment-docs --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/segment-docs .agents/skills/segment-docs && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "segment-docs" agent skill from https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docs into .agents/skills/segment-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "segment-docs", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install JanDeDobbeleer/oh-my-posh segment-docs --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/segment-docs .cursor/skills/segment-docs && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "segment-docs" agent skill from https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docs into .cursor/skills/segment-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "segment-docs", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/JanDeDobbeleer/oh-my-posh.git --path .agents/skills/segment-docs--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install JanDeDobbeleer/oh-my-posh segment-docs --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/segment-docs .gemini/skills/segment-docs && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "segment-docs" agent skill from https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docs into .gemini/skills/segment-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "segment-docs", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install JanDeDobbeleer/oh-my-posh segment-docsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/segment-docs .github/skills/segment-docs && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "segment-docs" agent skill from https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docs into .github/skills/segment-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "segment-docs", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install JanDeDobbeleer/oh-my-posh segment-docs --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/JanDeDobbeleer/oh-my-posh.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/segment-docs .opencode/skills/segment-docs && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "segment-docs" agent skill from https://github.com/JanDeDobbeleer/oh-my-posh/tree/main/.agents/skills/segment-docs into .opencode/skills/segment-docs/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "segment-docs", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
segment-docs- GitHub stars
- 24k
- Token cost
- ~1.1k tokens
- SKILL.md length
- 343 words
- Files
- 1
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- MIT
At a glance
Reference mapping between Oh My Posh Go segment source code and MDX documentation.
- Auditing segment documentation
- SKILL.md covers Go-to-Documentation Type Mapping, Extracting Options from Go…, Extracting Template Properties… and Key Source Files for Inherited…
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Reading segment Go code and needing to understand how code constructs map to user-facing options
What it does
Segment Docs is an agent skill from JanDeDobbeleer/oh-my-posh. Reference mapping between Oh My Posh Go segment source code and MDX documentation. Use when creating, updating, or auditing segment documentation, or when reading segment Go code and needing to understand how code constructs map to user-facing options, template properties, and type representations in docs.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering Markdown. It works with Bash. The repository describes itself as: The most customisable and low-latency cross platform/shell prompt renderer. The licence is MIT.
When your agent uses it
- Auditing segment documentation
- Reading segment Go code and needing to understand how code constructs map to user-facing options
- Template properties
- Type representations in docs
Example prompts
- “/segment-docs”
What it can do on your machine
Read from SKILL.md and the folder at commit 1d6bd96. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are go and mdx).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Segment Docs loads about 1.1k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 343 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from JanDeDobbeleer/oh-my-posh at commit 1d6bd96, republished under its MIT licence (© JanDeDobbeleer). 343 words, ~1,066 tokens.
Download SKILL.mdSave it as
.claude/skills/segment-docs/SKILL.md (or your agent's skills folder).- name
- segment-docs
- description
- Reference mapping between Oh My Posh Go segment source code and MDX documentation. Use when creating, updating, or auditing segment documentation, or when reading segment Go code and needing to understand how code constructs map to user-facing options, template properties, and type representations in docs.
Segment Documentation Reference
Go-to-Documentation Type Mapping
When reading a segment's Go source to document its options, determine the type from the
Provider method used to read the option value:
| Go method call | Documentation type |
|---|---|
options.Bool(option, default) | boolean |
options.String(option, default) | string |
options.StringArray(option, default) | []string |
options.Int(option, default) | int |
options.Float64(option, default) | float64 |
options.KeyValueMap(option, default) | map[string]string |
options.Color(option, default) | string |
options.Template(option, default, ctx) | string |
options.Any(option, default) | any |
Extracting Options from Go Source
Options are declared as options.Option string constants in the segment's const block:
const (
BranchIcon options.Option = "branch_icon" // option name used in config
NativeStatus options.Option = "native_status"
)The option name is the string literal value (e.g., "branch_icon").
The type and default value come from the getter call in Enabled() or init-like methods:
s.icon = s.options.String(BranchIcon, "\uE0A0")
// ^^^^^^ → string type, "\uE0A0" → defaultShared options
The following options are defined in src/segments/options/map.go and available to all
segments without appearing in a segment-specific const block:
| Option name | Type | Default |
|---|---|---|
always_enabled | boolean | false |
display_default | boolean | true |
display_error | boolean | true |
http_timeout | int | 20 |
cache_duration | int | varies |
access_token | string | "" |
refresh_token | string | "" |
version_url_template | string | "" |
files | []string | varies |
Extracting Template Properties from Go Source
Template properties are values available inside the segment's template string.
Rules for what becomes a template property:
- Exported struct fields (capitalized) on the segment struct →
.FieldName - Unexported fields are not accessible in templates
- Nested struct fields use dot notation: a field
Working ScmStatusexposes.Working.Modified,.Working.Added, etc. - Zero-argument methods with a single return value →
.MethodName - Document fields that are assigned in
Enabled()or its callees, not every inherited field from embedded structs is populated by every segment
The default template comes from the Template() method:
func (s *MySegment) Template() string {
return " {{ .FieldName }} "
}Nested struct subsection convention
When a property's type is itself a struct, add an #### TypeName subsection within
the Properties table section listing its exported fields. Example:
#### Status
| Name | Type | Description |
| ---- | ---- | ----------- |
| `.Modified` | `int` | Number of modified files |
| `.Added` | `int` | Number of added files |
| `.Deleted` | `int` | Number of deleted files |
| `.Untracked` | `int` | Number of untracked files |
| `.Changed` | `boolean` | Whether any changes exist |Key Source Files for Inherited Fields
When a segment embeds a base struct, its inherited fields may also be template properties. Check these files to discover what fields are available:
| File | What it defines |
|---|---|
src/segments/options/map.go | Provider interface method signatures; shared Option constants |
src/segments/base.go | Base struct embedded by all segments; provides options, env |
src/segments/scm.go | ScmStatus type with working/staging status fields (git, mercurial, etc.) |
src/segments/language.go | Version type and language base fields (Python, Node, Go, etc.) |
© JanDeDobbeleer, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/segment-docs of JanDeDobbeleer/oh-my-posh.
Open the folder on GitHubat commit 1d6bd96
Compare with similar skills
Segment Docs next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Segment Docs this skillJanDeDobbeleer/oh-my-posh | 24k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Piclist Uploadcat-xierluo/legal-skills | 713 | — | ~701 | Automated safety check: Pass | MIT | |
| Markdown Exporterbowenliang123/markdown-exporter | 271 | 1 repos | ~5.3k | Automated safety check: Pass | Apache-2.0 | |
| Markdown Article FormatterJimLiu/baoyu-skills | 26k | 6 repos | ~3.5k | Automated safety check: Pass | MIT | |
| MarkitdownImCa0/just-laws | 781 | 14 repos | ~3.2k | Automated safety check: Notes | MIT | |
| Obsidian MarkdownAtmosphere/atmosphere | 3.8k | 20 repos | ~1.3k | Automated safety check: Pass | Apache-2.0 |
Similar skills
Markdown Exporter
bowenliang123/markdown-exporter
Convert Markdown text to DOCX, PPTX, XLSX, PDF, PNG, SVG, HTML, IPYNB, MD, CSV, JSON, JSONL, XML files, and extract code blocks in Markdown to Python, Bash,JS and etc files.
Markdown Article Formatter
JimLiu/baoyu-skills
Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.
Markitdown
ImCa0/just-laws
Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.
Obsidian Markdown
Atmosphere/atmosphere
Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.
Gzh Design
isjiamu/gzh-design-skill
微信公众号文章排版引擎，将 Markdown 转换为可直接粘贴到公众号编辑器的 HTML。主题风格从 references/theme-index.md 注册的自定义主题库中选取，自动章节编号、关键词下划线标记、引言卡片、目录导航、代码块、图片/GIF、作者签名。支持 Markdown / Word(.docx) / PDF / 纯文本输入（非 Markdown…
More from JanDeDobbeleer/oh-my-posh
All 11 skills in this repoSegment Create
JanDeDobbeleer/oh-my-posh
Full scaffolding workflow for creating a new Oh My Posh segment.
Architecture
JanDeDobbeleer/oh-my-posh
Cross-language architecture and clean-code principles for this project: Clean Code, Object Calisthenics, SOLID, guard clauses, hot-path cost, and the code review checklist.
Conventional Commit
JanDeDobbeleer/oh-my-posh
Workflow for generating conventional commit messages following the Conventional Commits specification.
Golang
JanDeDobbeleer/oh-my-posh
Go coding standards and conventions for this project. An agent skill from JanDeDobbeleer/oh-my-posh.
Markdown
JanDeDobbeleer/oh-my-posh
Markdown formatting rules for this project. An agent skill from JanDeDobbeleer/oh-my-posh.
Powershell
JanDeDobbeleer/oh-my-posh
PowerShell cmdlet conventions for this project. An agent skill from JanDeDobbeleer/oh-my-posh.
Related
Works with
Categories
Questions about Segment Docs
What does Segment Docs do?
Reference mapping between Oh My Posh Go segment source code and MDX documentation. Segment Docs is an agent skill from JanDeDobbeleer/oh-my-posh. Reference mapping between Oh My Posh Go segment source code and MDX documentation.
When should I use Segment Docs?
Segment Docs fits situations like: auditing segment documentation; reading segment Go code and needing to understand how code constructs map to user-facing options; template properties; type representations in docs.
How do I install Segment Docs in Claude Code?
Run `npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a claude-code`. Or copy the skill folder (.agents/skills/segment-docs in JanDeDobbeleer/oh-my-posh) into .claude/skills/segment-docs in your project. Claude Code loads it when a task matches its description.
How do I install Segment Docs in Codex?
Run `npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a codex`. Or copy the skill folder (.agents/skills/segment-docs in JanDeDobbeleer/oh-my-posh) into .agents/skills/segment-docs in your project. Codex loads it when a task matches its description.
Can I use Segment Docs in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JanDeDobbeleer/oh-my-posh --skill segment-docs -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/segment-docs, .gemini/skills/segment-docs, .github/skills/segment-docs and .opencode/skills/segment-docs in your project.
What does Segment Docs need to run?
SKILL.md names no scripts, command-line tools or credentials: Segment Docs is instructions for the agent only.
Does Segment Docs access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Segment Docs safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Segment Docs use?
Segment Docs is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Segment Docs use?
About 1.1k tokens (SKILL.md is roughly 4.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Segment Docs?
Skills that share tags, products or a category with Segment Docs: Piclist Upload (cat-xierluo/legal-skills, 713 stars), Markdown Exporter (bowenliang123/markdown-exporter, 271 stars), Markdown Article Formatter (JimLiu/baoyu-skills, 26k stars) and Markitdown (ImCa0/just-laws, 781 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Segment Docs?
JanDeDobbeleer (a GitHub user) maintains it in JanDeDobbeleer/oh-my-posh, which has 23,555 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 7, 2026.
Source: JanDeDobbeleer/oh-my-posh on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.