nepse-trading-skill 1.0.0 → 1.0.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 +249 -20
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -89,39 +89,225 @@ Modelled on [tradermonty/claude-trading-skills](https://github.com/tradermonty/c
|
|
|
89
89
|
| `nepse-portfolio-manager` | Holdings CSV to net value, concentration, losers, tax clock | `portfolio_review.py` |
|
|
90
90
|
| `nepse-trade-journal` | Plan at entry, result at exit in R after charges and tax, statistics by setup | `journal.py` |
|
|
91
91
|
|
|
92
|
-
##
|
|
92
|
+
## Install by asking your agent
|
|
93
93
|
|
|
94
|
-
|
|
94
|
+
Paste this into the chat of Claude Code, Codex or Gemini CLI. The agent runs the install itself:
|
|
95
95
|
|
|
96
|
-
```
|
|
97
|
-
|
|
98
|
-
```
|
|
96
|
+
```text
|
|
97
|
+
Install the NEPSE trading skills from npm for me.
|
|
99
98
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
99
|
+
1. Check that python3 is version 3.9 or newer and that npx is available. If either is missing, stop and tell me what to install.
|
|
100
|
+
2. Run: npx --yes nepse-trading-skill@latest
|
|
101
|
+
3. Confirm the install worked: list the nepse-* folders in ~/.claude/skills and ~/.agents/skills (there should be 18 in each), then run
|
|
102
|
+
python3 ~/.agents/skills/nepse-cost-tax-calculator/scripts/cost_calculator.py breakeven --price 450 --qty 1000
|
|
103
|
+
and show me the result line.
|
|
104
|
+
4. Tell me to restart this agent so it loads the new skills.
|
|
103
105
|
|
|
104
|
-
|
|
105
|
-
python3 ~/.nepse-skills/skills/nepse-market-breadth-analyzer/scripts/breadth.py
|
|
106
|
+
Do not change any other files or settings.
|
|
106
107
|
```
|
|
107
108
|
|
|
108
|
-
|
|
109
|
-
python3 ~/.nepse-skills/skills/nepse-sector-analyst/scripts/sector_rotation.py
|
|
110
|
-
```
|
|
109
|
+
After the restart, start with:
|
|
111
110
|
|
|
112
|
-
```
|
|
113
|
-
|
|
111
|
+
```text
|
|
112
|
+
Run today's NEPSE analysis for Rs 30,000 using the nepse-daily-analyst skill.
|
|
114
113
|
```
|
|
115
114
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
115
|
+
- The agent asks before running `npx`, because it downloads and runs code. Approve it.
|
|
116
|
+
- Codex's default sandbox blocks network access and writes outside the project. Approve the escalation when it asks.
|
|
117
|
+
- This works in the terminal agents (Claude Code, Codex CLI, Gemini CLI), which can run commands on your computer. The web chats (claude.ai, ChatGPT, gemini.google.com) cannot install local skills.
|
|
118
|
+
|
|
119
|
+
## Getting started
|
|
120
|
+
|
|
121
|
+
1. **Install** (macOS or Linux, Python 3.9 or newer):
|
|
122
|
+
|
|
123
|
+
```bash
|
|
124
|
+
npx nepse-trading-skill
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
2. **Restart your agent** (Claude Code, Codex, Gemini CLI). It loads the `nepse-*` skills on start. To check, ask "which NEPSE skills do you have?", or in Gemini CLI run `gemini skills list`.
|
|
128
|
+
3. **Ask a question in plain words.** The agent picks the skill, runs its script and explains the result. Start with:
|
|
129
|
+
|
|
130
|
+
> Run today's NEPSE analysis for Rs 50,000
|
|
131
|
+
|
|
132
|
+
4. **Read the stance line first.** Every analysis opens with either "No trade today" or the stocks at their trigger price, then the cautions. Then come the plan (quantity, stop, target) and the timing rules: when to buy and when to sell.
|
|
133
|
+
|
|
134
|
+
You can also run any script yourself. Every script prints Markdown, takes `--help`, and with `--output-dir reports/` saves a timestamped `.json` and `.md` in the folder you run it from:
|
|
119
135
|
|
|
120
136
|
```bash
|
|
121
|
-
python3 ~/.nepse-skills/skills/nepse-
|
|
137
|
+
python3 ~/.nepse-skills/skills/nepse-daily-analyst/scripts/daily_analysis.py --account-size 50000 --output-dir reports/
|
|
122
138
|
```
|
|
123
139
|
|
|
124
|
-
|
|
140
|
+
### Best times to run
|
|
141
|
+
|
|
142
|
+
| When (Nepal time) | What to run | Why |
|
|
143
|
+
|---|---|---|
|
|
144
|
+
| After 11:30 | Daily analysis | Enough trades for breadth and sentiment to mean something |
|
|
145
|
+
| About 14:45 | Daily analysis again, or the pre-trade gate | Confirm a breakout before the 15:00 close |
|
|
146
|
+
| After 15:00 | Daily analysis | Complete daily bar; plan for the next session |
|
|
147
|
+
| Weekend | Sector ranking, technical and fundamental work, portfolio review | No live tape; prices are Friday's close |
|
|
148
|
+
|
|
149
|
+
## Skill reference
|
|
150
|
+
|
|
151
|
+
Each skill below shows what it does, what to ask, the command the agent runs, and what comes back. Paths start at `~/.nepse-skills/skills/`.
|
|
152
|
+
|
|
153
|
+
### nepse-daily-analyst: start here
|
|
154
|
+
|
|
155
|
+
The whole analysis in one command: market regime and exposure ceiling, breadth, news and sentiment, sector ranking, momentum screen, and for each candidate its trigger status, gate verdict, quantity for your capital, stop and 2R target. It ends with the rules for when to buy and when to sell.
|
|
156
|
+
|
|
157
|
+
- **Ask:** "Run today's NEPSE analysis for Rs 30,000", "What should I watch today?", "Include NTC and NABIL"
|
|
158
|
+
- **Run:** `nepse-daily-analyst/scripts/daily_analysis.py --account-size 30000 --risk-pct 1.5 --max-position-pct 50 --symbols NTC NABIL`
|
|
159
|
+
- **Options:** `--account-size` (required, rupees), `--top` (universe, default 100), `--candidates` (default 8), `--symbols` (always include), `--risk-pct` (default 1), `--max-position-pct` (default 20)
|
|
160
|
+
- **You get:** a stance line, market table, headlines, sector table, candidate table and timing rules
|
|
161
|
+
- **Trigger status:** BUILDING (more than 3% below the trigger), NEAR (within 3%), TRIGGERED (above it with volume on pace), TRIGGERED, LOW VOLUME, CONFIRMED (closed above on 1.5× volume), WEAK BREAKOUT, EXTENDED (more than 3% above; the entry is missed)
|
|
162
|
+
- **Small accounts:** under about Rs 100,000 the defaults give zero kitta for most stocks. Use `--risk-pct 1.5 --max-position-pct 50` and expect a break-even of 1.3% to 2% per trade.
|
|
163
|
+
|
|
164
|
+
### nepse-market-rules
|
|
165
|
+
|
|
166
|
+
NEPSE's trading rules as of November 2026, and today's price bands for a stock or the index.
|
|
167
|
+
|
|
168
|
+
- **Ask:** "Is NEPSE open now?", "Where is NABIL's upper circuit today?", "When does the market halt?"
|
|
169
|
+
- **Run:** `nepse-market-rules/scripts/price_bands.py --symbol NABIL`, or `--prev-close 549 --open 550 --ltp 560`, or `--index-prev-close 2655`
|
|
170
|
+
- **You get:** the session by the clock, the pre-open band (±5%), the queued-order band (±15%), the daily limit (±15%), the next order band (±3%), room left to each limit, and the index levels that halt trading (5% for 15 minutes before 13:00; 8% closes the day)
|
|
171
|
+
- **Covers:** Monday to Friday trading, 10:30 pre-open, 11:00 to 15:00 trading, T+2 settlement, lots of 10 kitta, no stop or market orders, no short selling, the new-listing opening range
|
|
172
|
+
|
|
173
|
+
### nepse-cost-tax-calculator
|
|
174
|
+
|
|
175
|
+
Exact rupee costs of a trade: commission (0.36% to 0.24% by slab, minimum Rs 10), SEBON fee (0.015%), DP charge (Rs 25 per side) and capital gains tax (5% held 365 days or less, 3.75% after, for individuals).
|
|
176
|
+
|
|
177
|
+
- **Ask:** "What do I pay for 100 NABIL at 550?", "Net profit if I sell 1,000 at 560 after 200 days?", "What is my break-even?"
|
|
178
|
+
- **Run:** `nepse-cost-tax-calculator/scripts/cost_calculator.py buy --price 500 --qty 100`
|
|
179
|
+
- **Modes:** `buy`, `sell --cost-per-share 451.58 --holding-days 200`, `roundtrip --price 450 --sell-price 560 --qty 1000 --holding-days 200`, `breakeven --price 450 --qty 1000`
|
|
180
|
+
- **You get:** every charge line, total payable or net receivable, tax, net profit, net and gross return
|
|
181
|
+
- **Example:** 100 shares at Rs 500 costs Rs 50,212.50 in total. Buying 1,000 at Rs 450 needs a sale at Rs 453.20 or more to break even.
|
|
182
|
+
|
|
183
|
+
### nepse-corporate-actions-calculator
|
|
184
|
+
|
|
185
|
+
The effect of a bonus share, right share or cash dividend on price, quantity, average cost and tax.
|
|
186
|
+
|
|
187
|
+
- **Ask:** "What will the price be after a 15% bonus?", "Should I apply for the 1:1 right?", "How much tax on my bonus?"
|
|
188
|
+
- **Run:** `nepse-corporate-actions-calculator/scripts/corporate_actions.py --price 550 --qty 500 --wacc 480 --bonus-pct 10 --cash-pct 0.5263`
|
|
189
|
+
- **Options:** `--price`, `--qty` (required), `--wacc`, `--bonus-pct`, `--cash-pct`, `--right-pct` (new shares per 100 held: 1:0.5 is 50), `--right-price` (default 100)
|
|
190
|
+
- **You get:** the adjusted price after book closure, bonus and right shares, the money a right needs, 5% tax, any tax you must pay the company, and your new average cost
|
|
191
|
+
|
|
192
|
+
### nepse-market-regime-detector
|
|
193
|
+
|
|
194
|
+
Is the market in an uptrend, correcting or bottoming? It reads the trend, distribution days and follow-through days and turns them into one number: how much of normal buying to allow.
|
|
195
|
+
|
|
196
|
+
- **Ask:** "Is NEPSE bullish?", "Has the market bottomed?", "How much should I be invested?"
|
|
197
|
+
- **Run:** `nepse-market-regime-detector/scripts/market_regime.py`, or `--index Banking` (or Hydropower, Microfinance and the other sub-indices)
|
|
198
|
+
- **You get:** a regime name and an exposure ceiling from 0% to 100%, the moving averages, distance from the high, distribution days in the last 25 sessions, and the date of the latest follow-through day
|
|
199
|
+
- **Ceilings:** 100% in a confirmed uptrend, 60% under pressure or in recovery, 40% in a pullback, 50% after a follow-through day, 20% in a rally attempt, 0% in a downtrend
|
|
200
|
+
|
|
201
|
+
### nepse-market-breadth-analyzer
|
|
202
|
+
|
|
203
|
+
How many stocks are taking part in the move. Scored 0 to 100 from advancers and decliners, turnover in rising stocks, the median move, sector participation and turnover concentration.
|
|
204
|
+
|
|
205
|
+
- **Ask:** "How broad is today's rally?", "Is the index being held up by a few stocks?"
|
|
206
|
+
- **Run:** `nepse-market-breadth-analyzer/scripts/breadth.py`, or `--deep` to add the share of stocks above their 20, 50 and 200-day averages (about a minute)
|
|
207
|
+
- **You get:** a score and zone (Strong 70+, Healthy 55+, Neutral 40+, Weak 25+, Washed out), the component scores and a sector table
|
|
208
|
+
|
|
209
|
+
### nepse-sector-analyst
|
|
210
|
+
|
|
211
|
+
Ranks NEPSE's 13 sector indices by strength against the NEPSE index over 1 week, 1 month, 3 months and 6 months.
|
|
212
|
+
|
|
213
|
+
- **Ask:** "Which sectors are leading?", "Banks or hydropower?"
|
|
214
|
+
- **Run:** `nepse-sector-analyst/scripts/sector_rotation.py`
|
|
215
|
+
- **You get:** a ranked table, each sector's phase (Leading, Improving, Weakening, Lagging), and its position against its 50-day and 200-day averages
|
|
216
|
+
|
|
217
|
+
### nepse-news-sentiment-analyst
|
|
218
|
+
|
|
219
|
+
Market and company news with a sentiment reading. Headlines come from ShareSansar, the Kathmandu Post (business) and OnlineKhabar (economy); company notices come from NEPSE.
|
|
220
|
+
|
|
221
|
+
- **Ask:** "What is the market sentiment?", "Any news on SAHAS?", "Why is NEPSE falling today?"
|
|
222
|
+
- **Run:** `nepse-news-sentiment-analyst/scripts/news_sentiment.py --days 3`, or `--symbol SAHAS --days 30`
|
|
223
|
+
- **You get:** a combined score from −100 to +100 (news and tape mood), the headlines with their scores, and for a stock its news plus NEPSE notices from the last 90 days
|
|
224
|
+
- **Note:** the score comes from a word list. The skill tells the agent to read the headlines and correct it.
|
|
225
|
+
|
|
226
|
+
### nepse-liquidity-macro-monitor
|
|
227
|
+
|
|
228
|
+
A research checklist for the money behind the market: interbank and deposit rates, credit, NRB policy, share-loan rules, remittance, reserves, inflation and the budget. There is no script; the agent searches for current figures and fills a 10-line scorecard.
|
|
229
|
+
|
|
230
|
+
- **Ask:** "Why is the market rising?", "How does NRB policy affect shares?", "What is the macro outlook for NEPSE?"
|
|
231
|
+
- **You get:** tailwind, neutral or headwind, with a dated scorecard, where the market is in the liquidity cycle, sector effects and the events in the next 30 days
|
|
232
|
+
|
|
233
|
+
### nepse-momentum-screener
|
|
234
|
+
|
|
235
|
+
Finds stocks in strong uptrends resting near their highs: the setup that comes before most big moves.
|
|
236
|
+
|
|
237
|
+
- **Ask:** "Find breakout candidates", "Strongest stocks in hydropower", "Screen NABIL NBL GBIME"
|
|
238
|
+
- **Run:** `nepse-momentum-screener/scripts/screen_momentum.py --top 100`, `--sector "Hydro Power"`, or `--symbols NABIL NBL GBIME`
|
|
239
|
+
- **Options:** `--min-template` (checks needed out of 7, default 6), `--min-turnover` (default Rs 2,000,000 a day), `--limit`
|
|
240
|
+
- **You get:** score, trend-template result, relative-strength rank, 10-day range, volume dry-up, pivot (trigger) and distance to it
|
|
241
|
+
|
|
242
|
+
### nepse-technical-analyst
|
|
243
|
+
|
|
244
|
+
A numbers-first chart read of one stock, the NEPSE index or a sector index.
|
|
245
|
+
|
|
246
|
+
- **Ask:** "Analyse NABIL technically", "Support and resistance for NTC", "Is GBIME in an uptrend?"
|
|
247
|
+
- **Run:** `nepse-technical-analyst/scripts/technical_snapshot.py --symbol NABIL` (also `--symbol NEPSE`, `--symbol Banking`)
|
|
248
|
+
- **You get:** trend stage, the 20, 50, 150 and 200-day averages, RSI, MACD, ATR, 52-week range, returns, volume against average, 10-day range, support and resistance; the agent adds scenarios with entry, stop and target
|
|
249
|
+
|
|
250
|
+
### nepse-fundamental-analyst
|
|
251
|
+
|
|
252
|
+
Valuation and quality checks from a company's quarterly report.
|
|
253
|
+
|
|
254
|
+
- **Ask:** "Is NABIL overvalued?", "Analyse Global IME Bank's Q1 results", "Compare two hydropower companies"
|
|
255
|
+
- **Run:** `nepse-fundamental-analyst/scripts/valuation.py --symbol NABIL --eps 30.34 --bvps 233.9 --sector bank --npl-pct 4.1 --car-pct 12.6 --dividend-pct 10.8 --deposit-rate 4`
|
|
256
|
+
- **Options:** `--eps` and `--bvps` are required (no free feed has them; the agent reads them from the report); `--sector` is one of bank, devbank, finance, microfinance, life, nonlife, hydro, manufacturing, hotel, investment, other
|
|
257
|
+
- **You get:** PE, PBV, ROE, earnings yield against the deposit rate, Graham number, PEG and cash yield, plus positives, flags and a verdict
|
|
258
|
+
|
|
259
|
+
### nepse-dividend-screener
|
|
260
|
+
|
|
261
|
+
Dividend record turned into yield on today's price.
|
|
262
|
+
|
|
263
|
+
- **Ask:** "Best dividend banks", "When is NMB's book closure?", "Income stocks paying 4% or more"
|
|
264
|
+
- **Run:** `nepse-dividend-screener/scripts/dividend_screener.py --sector "Commercial Banks" --top 20`, or `--symbols NABIL HBL NMB`
|
|
265
|
+
- **Options:** `--min-years` (years paid out of 5), `--min-cash-yield`
|
|
266
|
+
- **You get:** latest cash and bonus percentages, cash yield and net yield after 5% tax, 5-year averages, years paid and the next book-closure date
|
|
267
|
+
|
|
268
|
+
### nepse-ipo-analyzer
|
|
269
|
+
|
|
270
|
+
Public offerings now open, coming up, and closed but not yet listed. It also explains applying, allotment, the listing range and selling at listing.
|
|
271
|
+
|
|
272
|
+
- **Ask:** "Which IPOs are open?", "Should I apply for this IPO?", "When should I sell my IPO shares?"
|
|
273
|
+
- **Run:** `nepse-ipo-analyzer/scripts/ipo_calendar.py`, or `--type Ipo` (other types include MutualFund and BondOrDebenture)
|
|
274
|
+
- **You get:** each offering's units, price, dates, issue manager, and who may apply (general public, local people, migrant workers)
|
|
275
|
+
|
|
276
|
+
### nepse-position-sizer
|
|
277
|
+
|
|
278
|
+
How many kitta to buy so that a stop-out costs a set share of your account, after charges and within liquidity and concentration limits.
|
|
279
|
+
|
|
280
|
+
- **Ask:** "How many SAHAS can I buy with Rs 10 lakh and a stop at 680?"
|
|
281
|
+
- **Run:** `nepse-position-sizer/scripts/position_sizer.py --account-size 1000000 --entry 548 --stop 528`, or `--symbol NABIL --atr-multiplier 2.5` for an ATR stop
|
|
282
|
+
- **Options:** `--risk-pct` (default 1), `--max-position-pct` (default 20), `--max-sector-pct`, `--current-sector-exposure`, `--lot` (default 10), `--max-adv-pct` (default 10% of average volume), Kelly with `--win-rate --avg-win --avg-loss`
|
|
283
|
+
- **You get:** kitta (whole lots), which limit set the size, total payable and the loss if stopped
|
|
284
|
+
|
|
285
|
+
### nepse-pre-trade-gate
|
|
286
|
+
|
|
287
|
+
A PASS, WARN or BLOCK checklist on a planned buy, run just before you place the order in TMS.
|
|
288
|
+
|
|
289
|
+
- **Ask:** "I am about to buy 300 NABIL at 548 with a stop at 528. Check it."
|
|
290
|
+
- **Run:** `nepse-pre-trade-gate/scripts/pre_trade_gate.py --symbol NABIL --account-size 1000000 --qty 300 --stop 528 --target 600`
|
|
291
|
+
- **Checks:** risk per trade, position size, reward to risk after charges and tax, liquidity, stop distance, chasing, room to the upper limit, extension, market regime and upcoming book closure
|
|
292
|
+
- **You get:** one verdict and a line per check. The command exits with code 2 on BLOCK.
|
|
293
|
+
|
|
294
|
+
### nepse-portfolio-manager
|
|
295
|
+
|
|
296
|
+
A review of your holdings: value, net profit if sold today, concentration, losers that need a decision, and days left to the lower tax rate.
|
|
297
|
+
|
|
298
|
+
- **Ask:** "Review my portfolio" (paste your MeroShare table)
|
|
299
|
+
- **Run:** `nepse-portfolio-manager/scripts/portfolio_review.py --holdings state/holdings.csv`
|
|
300
|
+
- **Input CSV:** `symbol,quantity,wacc,buy_date` (buy_date as YYYY-MM-DD, optional; one row per lot)
|
|
301
|
+
- **You get:** totals, a holdings table, sector weights and alerts (positions over 20%, sectors over 40%, losers past −15%, tax savings within 45 days)
|
|
302
|
+
|
|
303
|
+
### nepse-trade-journal
|
|
304
|
+
|
|
305
|
+
Records each trade's plan at entry and its result at exit, then scores you in R (multiples of the planned risk) after charges and tax.
|
|
306
|
+
|
|
307
|
+
- **Ask:** "Log my NTC buy: 30 at 943.90, stop 913.7, breakout", "Show my trading stats"
|
|
308
|
+
- **Run:** `nepse-trade-journal/scripts/journal.py open --symbol NTC --qty 30 --entry 943.9 --stop 913.7 --target 1035 --setup breakout --thesis "..."`, then `close --id 1 --exit 1000 --reason target`, `list`, `stats`
|
|
309
|
+
- **You get:** win rate, expectancy in R, profit factor, average holding days, tax paid and results by setup
|
|
310
|
+
- **Stored in:** `~/.nepse-skills/state/journal.json`, on your machine only
|
|
125
311
|
|
|
126
312
|
## Install for Claude Code, Codex, Gemini CLI and others
|
|
127
313
|
|
|
@@ -158,6 +344,49 @@ Do not install single skills with an agent's own installer (for example `gemini
|
|
|
158
344
|
|
|
159
345
|
Inside this repository the skills also load as project skills (`.claude/skills` and `.agents/skills` link to `skills/`), and `AGENTS.md` (read by Codex; `CLAUDE.md` and `GEMINI.md` point to it) holds the working rules. Run `./install.sh` once here too: the commands use `~/.nepse-skills`.
|
|
160
346
|
|
|
347
|
+
## Updating and removing
|
|
348
|
+
|
|
349
|
+
| Task | Command |
|
|
350
|
+
|---|---|
|
|
351
|
+
| Update to the latest version | `npx nepse-trading-skill@latest` |
|
|
352
|
+
| Remove the skills | `npx nepse-trading-skill --uninstall` |
|
|
353
|
+
| Remove everything, including your journal | Run the uninstall, then delete `~/.nepse-skills` |
|
|
354
|
+
|
|
355
|
+
Updating replaces the skills and shared code and keeps `~/.nepse-skills/state` and `~/.nepse-skills/.cache`.
|
|
356
|
+
|
|
357
|
+
## Troubleshooting
|
|
358
|
+
|
|
359
|
+
| Problem | Fix |
|
|
360
|
+
|---|---|
|
|
361
|
+
| The agent does not list the skills | Restart it. Check that `~/.claude/skills/nepse-daily-analyst` (Claude Code) or `~/.agents/skills/nepse-daily-analyst` (Codex, Gemini) exists. Run the installer again. |
|
|
362
|
+
| "skipped …: a folder with that name already exists" | A real folder with that name is in the way. Move it, then reinstall. |
|
|
363
|
+
| `~/.nepse-skills exists and is not a link` | You installed from npm before and now install from git. Move `~/.nepse-skills` away (keep its `state/`), then run `install.sh`. |
|
|
364
|
+
| `python3 3.9 or newer is required` | Install Python 3.9+ (python.org or Homebrew). |
|
|
365
|
+
| "did not trade today" or "no price history" | The stock had no trade yet today, or the symbol is wrong. Check the symbol on ShareSansar or Merolagani. |
|
|
366
|
+
| "fetch failed" | A public data feed is down or has changed. Try again later. Feed addresses live in `nepse_common/data.py`. |
|
|
367
|
+
| Numbers look a day old | The market is closed (weekend or holiday). Scripts use the last session. |
|
|
368
|
+
| Windows | Not supported by the installer. Use WSL. |
|
|
369
|
+
|
|
370
|
+
## FAQ
|
|
371
|
+
|
|
372
|
+
**Is this investment advice?**
|
|
373
|
+
No. The skills turn public data and fixed rules into numbers and plans. They do not know your situation, and the agent does not place orders. You decide and you trade in TMS.
|
|
374
|
+
|
|
375
|
+
**Does it need an API key or a paid data plan?**
|
|
376
|
+
No. It uses free public feeds. They are unofficial and can be late, wrong or stop working.
|
|
377
|
+
|
|
378
|
+
**Does any of my data leave my computer?**
|
|
379
|
+
Your holdings and journal stay in `~/.nepse-skills/state`. The scripts only download public market data and news. Your agent (Claude, Codex, Gemini) sees what you type and what the scripts print, as with any other prompt.
|
|
380
|
+
|
|
381
|
+
**How current are the rules and tax rates?**
|
|
382
|
+
They were checked on 13 November 2026. NEPSE, SEBON and the Finance Ministry change them often; items that could not be confirmed are marked in the references. Check before a decision that depends on one number.
|
|
383
|
+
|
|
384
|
+
**Can I use it without an AI agent?**
|
|
385
|
+
Yes. Every script runs on its own with `python3` and prints Markdown. See `--help`.
|
|
386
|
+
|
|
387
|
+
**Why does a small account get zero kitta?**
|
|
388
|
+
The default limits are 1% risk and 20% per position. With lots of 10 kitta, a Rs 30,000 account often cannot buy one lot inside them. Raise the limits on purpose (`--risk-pct 1.5 --max-position-pct 50`) and accept the higher concentration.
|
|
389
|
+
|
|
161
390
|
## Workflows
|
|
162
391
|
|
|
163
392
|
Defined in `workflows/README.md`:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "nepse-trading-skill",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "18 AI agent skills for analysing and trading the Nepal Stock Exchange (NEPSE): daily analysis, market regime, breadth, news sentiment, sectors, momentum screen, position sizing, costs and tax, pre-trade gate. For Claude Code, Codex, Gemini CLI and other Agent Skills clients. Install with npx nepse-trading-skill.",
|
|
5
5
|
"bin": {
|
|
6
6
|
"nepse-trading-skill": "install.sh"
|