Skip to content

docs: add the skill for AI agents - #56

Merged
Insei merged 2 commits into
mainfrom
agent-skill
Oct 19, 2026
Merged

Insei merged 2 commits into
mainfrom
agent-skill

Conversation

@Insei

@Insei Insei commented Oct 19, 2026

Copy link
Copy Markdown
Owner

The skill for AI agents in the Agent Skills format, skills/tinyconf/SKILL.md. Models trained before v2 write Parse(conf) without the context and import github.com/insei/tinyconf without /v2; the skill gives them the current API.

  • The rules of v2, the tags, the drivers with their options and the common mistakes.
  • Three complete programs: a service with four drivers, sub configs with Current and Subscribe, the logger configured by the config.
  • scripts/check-skill.sh builds the programs against the code of the repository, CI runs it, so the skill can not describe the API that does not exist. The programs were also run by hand: the error of the required field, the priority of the flags over the environment, Sources, GenDoc, the deferred logger.

Insei added 2 commits October 19, 2026 06:48
…rograms

Signed-off-by: Dmitriy Aleksandrov <goodmobiledevices@gmail.com>
Signed-off-by: Dmitriy Aleksandrov <goodmobiledevices@gmail.com>
@codecov-commenter

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (7e2b443) to head (7c56ff8).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@            Coverage Diff            @@
##              main       #56   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           32        32           
  Lines         2630      2638    +8     
=========================================
+ Hits          2630      2638    +8     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@github-actions

Copy link
Copy Markdown
Contributor

Benchmark diff: 5f9bf99 → ae6847e (10 runs)

goos: linux
goarch: amd64
pkg: github.com/insei/tinyconf/v2
cpu: AMD EPYC 7763 64-Core Processor                
                    │   base.txt   │              head.txt               │
                    │    sec/op    │   sec/op     vs base                │
Parse-4               3.363µ ±  1%   3.382µ ± 1%        ~ (p=0.148 n=10)
Parse_SubConfig-4     1.553µ ±  0%   1.564µ ± 1%   +0.68% (p=0.000 n=10)
Current-4             66.86n ±  0%   55.52n ± 0%  -16.96% (p=0.000 n=10)
Current_SubConfig-4   116.5n ± 15%   100.3n ± 0%  -13.91% (p=0.022 n=10)
geomean               449.1n         414.2n        -7.76%

                    │    base.txt    │               head.txt                │
                    │      B/op      │     B/op      vs base                 │
Parse-4               1.344Ki ± 0%     1.344Ki ± 0%       ~ (p=1.000 n=10) ¹
Parse_SubConfig-4       392.0 ± 0%       392.0 ± 0%       ~ (p=1.000 n=10) ¹
Current-4               0.000 ± 0%       0.000 ± 0%       ~ (p=1.000 n=10) ¹
Current_SubConfig-4     0.000 ± 0%       0.000 ± 0%       ~ (p=1.000 n=10) ¹
geomean                            ²                 +0.00%                ²
¹ all samples are equal
² summaries must be >0 to compute geomean

                    │   base.txt   │              head.txt               │
                    │  allocs/op   │ allocs/op   vs base                 │
Parse-4               18.00 ± 0%     18.00 ± 0%       ~ (p=1.000 n=10) ¹
Parse_SubConfig-4     10.00 ± 0%     10.00 ± 0%       ~ (p=1.000 n=10) ¹
Current-4             0.000 ± 0%     0.000 ± 0%       ~ (p=1.000 n=10) ¹
Current_SubConfig-4   0.000 ± 0%     0.000 ± 0%       ~ (p=1.000 n=10) ¹
geomean                          ²               +0.00%                ²
¹ all samples are equal
² summaries must be >0 to compute geomean

pkg: github.com/insei/tinyconf/v2/drivers
                │  base.txt   │           head.txt            │
                │   sec/op    │   sec/op     vs base          │
Parse_Drivers-4   59.91µ ± 3%   59.70µ ± 1%  ~ (p=0.315 n=10)

                │   base.txt   │            head.txt            │
                │     B/op     │     B/op      vs base          │
Parse_Drivers-4   25.14Ki ± 0%   25.14Ki ± 0%  ~ (p=1.000 n=10)

                │  base.txt  │            head.txt            │
                │ allocs/op  │ allocs/op   vs base            │
Parse_Drivers-4   408.0 ± 0%   408.0 ± 0%  ~ (p=1.000 n=10) ¹
¹ all samples are equal

@Insei
Insei merged commit dc0a427 into main Oct 19, 2026
4 checks passed
@Insei
Insei deleted the agent-skill branch October 19, 2026 03:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants