@velinussage/locus-agent-skill 0.1.1 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +19 -5
- package/package.json +1 -1
- package/skill/locus-agent-tools/SKILL.md +6 -8
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# @velinussage/locus-agent-skill
|
|
2
2
|
|
|
3
|
+
[](https://skills.sh/velinussage/locus-agent-skill)
|
|
4
|
+
|
|
3
5
|
Install the Locus agent skill for agents that need cited property and local-government context over MCP, REST, A2A, free tools, and x402 paid reports.
|
|
4
6
|
|
|
5
7
|
Locus returns awareness and verification steps, not a verdict. Do not use it to score, rank, screen, value, predict, or label a person, property, block, or neighborhood as safe or unsafe.
|
|
@@ -20,20 +22,32 @@ npx @velinussage/locus-agent-skill add --target ./skills --force
|
|
|
20
22
|
npx @velinussage/locus-agent-skill --print
|
|
21
23
|
```
|
|
22
24
|
|
|
25
|
+
## Install with GitHub CLI
|
|
26
|
+
|
|
27
|
+
```bash
|
|
28
|
+
gh skill install velinussage/locus-agent-skill locus-agent-tools
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Preview first:
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
gh skill preview velinussage/locus-agent-skill locus-agent-tools
|
|
35
|
+
```
|
|
36
|
+
|
|
23
37
|
## Install with skills.sh
|
|
24
38
|
|
|
25
|
-
The same skill is also available from the GitHub repo through the open `skills` CLI:
|
|
39
|
+
The same skill is also available from the public GitHub repo through the open `skills` CLI:
|
|
26
40
|
|
|
27
41
|
```bash
|
|
28
|
-
npx skills add velinussage/locus --skill locus-agent-tools
|
|
42
|
+
npx skills add velinussage/locus-agent-skill --skill locus-agent-tools
|
|
29
43
|
```
|
|
30
44
|
|
|
31
45
|
Useful variants:
|
|
32
46
|
|
|
33
47
|
```bash
|
|
34
|
-
npx skills add velinussage/locus --skill locus-agent-tools -g
|
|
35
|
-
npx skills add velinussage/locus --skill locus-agent-tools -a claude-code -a codex
|
|
36
|
-
npx skills use velinussage/locus --skill locus-agent-tools
|
|
48
|
+
npx skills add velinussage/locus-agent-skill --skill locus-agent-tools -g
|
|
49
|
+
npx skills add velinussage/locus-agent-skill --skill locus-agent-tools -a claude-code -a codex
|
|
50
|
+
npx skills use velinussage/locus-agent-skill --skill locus-agent-tools
|
|
37
51
|
```
|
|
38
52
|
|
|
39
53
|
## Connect to Locus MCP
|
package/package.json
CHANGED
|
@@ -7,10 +7,8 @@ triggers:
|
|
|
7
7
|
- locus agent tools
|
|
8
8
|
- mcp or rest for locus
|
|
9
9
|
- a2a locus
|
|
10
|
-
allowed-tools:
|
|
11
|
-
|
|
12
|
-
- Read
|
|
13
|
-
- AskUserQuestion
|
|
10
|
+
allowed-tools: Bash Read AskUserQuestion
|
|
11
|
+
license: MIT
|
|
14
12
|
---
|
|
15
13
|
|
|
16
14
|
# Locus Agent Capabilities
|
|
@@ -25,7 +23,7 @@ Locus returns awareness and verification steps, not a verdict. Do not score, ran
|
|
|
25
23
|
- **National free tools cover all 50 states for geocodable US addresses.** Local lanes are wired jurisdiction by jurisdiction and are growing. Always expect national context. Treat local parcel, zoning, permit, tax, and development-case depth as coverage-dependent.
|
|
26
24
|
- **Start with `locus_place_facts` when lane availability says it is available.** It is the one-call address bundle for supported parcel areas: parcel facts, FEMA flood zone, governing districts, transportation context, and tax context where wired.
|
|
27
25
|
- **Use `locus_lane_availability` before paid calls.** It maps national, local, varies, not-covered, and degraded lanes, then gives per-paid-tool buy recommendations.
|
|
28
|
-
- **
|
|
26
|
+
- **Do not memorize paid prices from this skill.** Call the live paid catalog or `locus_lane_availability` for current `priceUsdc`, then read the x402 challenge for exact price, chain, recipient, and schema before payment.
|
|
29
27
|
|
|
30
28
|
## Quick connect
|
|
31
29
|
|
|
@@ -118,8 +116,8 @@ Trimmed response example for a rural Montana ZIP:
|
|
|
118
116
|
]
|
|
119
117
|
},
|
|
120
118
|
"buyRecommendations": [
|
|
121
|
-
{ "slug": "locus-place-report", "priceUsdc": "0.
|
|
122
|
-
{ "slug": "locus-environmental-context", "priceUsdc": "0.
|
|
119
|
+
{ "slug": "locus-place-report", "priceUsdc": "0.05", "substanceHere": "low", "rationale": "Coverage varies. Confirm the free component lanes first." },
|
|
120
|
+
{ "slug": "locus-environmental-context", "priceUsdc": "0.05", "substanceHere": "medium", "rationale": "Wired national EPA/SDWIS sources resolve here." }
|
|
123
121
|
],
|
|
124
122
|
"warnings": [
|
|
125
123
|
"Not covered does not mean no records exist. It only means Locus has no wired source yet."
|
|
@@ -268,7 +266,7 @@ Use the argument key from the tool schema. Do not send every place as `place`; m
|
|
|
268
266
|
## Paid report rules
|
|
269
267
|
|
|
270
268
|
- Unsupported or discovery-only places return a free diagnostic, not a payment challenge.
|
|
271
|
-
-
|
|
269
|
+
- Do not rely on remembered price ranges. Read `priceUsdc` from `locus_lane_availability` or the paid tool index, then confirm exact cost, network, asset, and recipient from the 402 challenge before payment.
|
|
272
270
|
- The price, network, asset, and recipient appear before payment.
|
|
273
271
|
- Paid results return only after settlement succeeds.
|
|
274
272
|
- Payment metadata binds to the tool and a canonical hash of arguments, not the raw address.
|