GitLabgitlab-org
cli
main
1package skill
3import (
4 "bytes"
5 "errors"
6 "regexp"
7 "strings"
9 "go.yaml.in/yaml/v3"
10)
12// Frontmatter holds the SKILL.md frontmatter keys glab reads.
13type Frontmatter struct {
14 Name string `yaml:"name"`
15 Description string `yaml:"description"`
16}
18// FrontmatterParts is a SKILL.md split around its YAML frontmatter so a
19// caller can edit Block and reassemble the file byte-for-byte otherwise.
20type FrontmatterParts struct {
21 // Head is any leading whitespace plus the opening `---` line.
22 Head []byte
23 // Block is the YAML between the delimiters, without the final line break.
24 Block []byte
25 // Tail starts at the line break before the closing `---` and runs to EOF.
26 Tail []byte
27}
29var closingDelimiter = regexp.MustCompile(`\r?\n---`)
31// SplitFrontmatter splits content at the first pair of `---` delimiters.
32// LF and CRLF line endings are both preserved in Head and Tail.
33func SplitFrontmatter(content []byte) (FrontmatterParts, error) {
34 const delim = "---"
35 trimmed := bytes.TrimLeft(content, " \t\r\n")
36 if !bytes.HasPrefix(trimmed, []byte(delim)) {
37 return FrontmatterParts{}, errors.New("missing leading '---' delimiter")
38 }
39 afterDelim := trimmed[len(delim):]
40 nl := bytes.IndexByte(afterDelim, '\n')
41 if nl == -1 {
42 return FrontmatterParts{}, errors.New("missing newline after opening '---'")
43 }
44 headLen := len(content) - len(afterDelim) + nl + 1
45 rest := content[headLen:]
46 loc := closingDelimiter.FindIndex(rest)
47 if loc == nil {
48 return FrontmatterParts{}, errors.New("missing closing '---' delimiter")
49 }
50 return FrontmatterParts{
51 Head: content[:headLen],
52 Block: rest[:loc[0]],
53 Tail: rest[loc[0]:],
54 }, nil
55}
57// Join reassembles the file from its parts.
58func (p FrontmatterParts) Join() []byte {
59 out := make([]byte, 0, len(p.Head)+len(p.Block)+len(p.Tail))
60 out = append(out, p.Head...)
61 out = append(out, p.Block...)
62 return append(out, p.Tail...)
63}
65// ParseFrontmatter decodes the frontmatter of a SKILL.md.
66func ParseFrontmatter(content []byte) (Frontmatter, error) {
67 var fm Frontmatter
68 parts, err := SplitFrontmatter(content)
69 if err != nil {
70 return fm, err
71 }
72 if err := yaml.Unmarshal(parts.Block, &fm); err != nil {
73 return fm, err
74 }
75 fm.Description = strings.TrimSpace(fm.Description)
76 return fm, nil
77}
Diagnostics8 git calls · 236 ms
CallStatusSizeTime0236 ms
discover200185 B4 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=2 git.response.bytes=185 git.server.agent=git/2.56.g1891de4-Linux git.server.object_format=sha1 git.server.caps=agent ls-refs fetch server-option object-format git.server.fetch=shallow wait-for-done filter git.protocol.version=2 git.pkt.frames=9 git.pkt.data=7 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=185 git.pkt.payload.max=35
ls-refs20058 KiB · hit3 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=3 git.response.bytes=59849 git.response.cache=HIT git.response.duration_ms=3 git.protocol.version=2 git.pkt.frames=731 git.pkt.data=730 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=59849 git.pkt.payload.max=143 git.ls_refs.count=730 git.ls_refs.head=refs/heads/main
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit1 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=1 git.response.bytes=4273 git.response.cache=HIT git.response.duration_ms=1 git.fetch.filter=combine:blob:none+tree:2 git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9 git.fetch.haves.count=0 git.fetch.deepen=1 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=7 git.pkt.data=5 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=4273 git.pkt.payload.max=4173 git.sideband.band1.bytes=4173 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=11 git.pack.bytes=4173 git.fetch.wide.objects=11 git.fetch.wide.extra_bytes=3930 git.fetch.wide.blobs=0
fetchtree:0 · deepen 1020032 KiB · hit2 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=32926 git.response.cache=HIT git.response.duration_ms=2 git.fetch.filter=tree:0 git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9 git.fetch.haves.count=0 git.fetch.deepen=10 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=22 git.pkt.data=20 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=32926 git.pkt.payload.max=32046 git.sideband.band1.bytes=32046 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=80 git.pack.bytes=32046 git.pack.ofs_delta=36 git.pack.ref_delta=0 git.pack.chain.max=2 git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91 git.pack.full=44Open pack map
fetchtree:02001.8 KiB · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=4 git.response.bytes=1857 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=tree:0 git.fetch.wants=dce174ff8c632a19d17eea99c8a9b7c37fb2b592 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1857 git.pkt.payload.max=1830 git.sideband.band1.bytes=1830 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=1 git.pack.bytes=1830 git.pack.trailer=fb03183b7909876778f740d196d7516811003517Open pack map
fetchtree:0200370 B · hit4 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=370 git.response.cache=HIT git.response.duration_ms=4 git.fetch.filter=tree:0 git.fetch.wants=290ae7a62f76e23cbbd60697570f19b90ddcece6 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=370 git.pkt.payload.max=343 git.sideband.band1.bytes=343 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=1 git.pack.bytes=343 git.pack.trailer=0795a26d2b25022c69da2ef2e68cfb92a77ef4bbOpen pack map
fetchtree:0200173 B · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=221 git.response.bytes=173 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=tree:0 git.fetch.wants=60647f914522b23d750596f23b0e02eda0449cf3 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=173 git.pkt.payload.max=146 git.sideband.band1.bytes=146 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=1 git.pack.bytes=146 git.pack.trailer=0753deda1fe26f3e81d7c3efc747a7269310f025Open pack map
fetch2001.0 KiB221 ms
git.upload-pack fetch http.response.status_code=200 git.response.bytes=1034 git.response.cache=MISS git.response.duration_ms=221 git.fetch.wants=4a4222e9cb8ebd9c92332bf15044ef4dc41ca0d7 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1034 git.pkt.payload.max=1007 git.sideband.band1.bytes=1007 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0
Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.
- Remote
- https://gitlab.com/gitlab-org/cli
- Ref
- refs/heads/main
- Commit
- 0dd7574dce9e385c5c30540e6c15657adc6bdce9
- cf-ray
- a5e2f3de1a2b7089
- Request
- ac9a5bf0…
- Protocol
- v2 · sha1
- Agent
- git/2.56.g1891de4-Linux
- Filter
- advertised
- Fetch
- shallow wait-for-done filter
- Capabilities
- agent ls-refs fetch server-option object-format