whatisgithub

What is price-action-analysis?

cheshiremew/price-action-analysis — explained in plain English

Analysis updated 2026-05-18

54PythonAudience · developerComplexity · 2/5Setup · easy

In one sentence

A Codex skill that annotates candlestick chart screenshots with price action analysis, marking channels, key levels, and a trading plan directly on the image.

Mindmap

mindmap
  root((price action analysis))
    What it does
      Chart annotation
      Trading plan overlay
      Historical review layer
    Tech stack
      Python
      Codex skill
    Analysis concepts
      Channels
      Trading ranges
      Breakouts
      Reversals
    Use cases
      Annotate chart screenshot
      Build trading plan
      Review past patterns
    Delivery rules
      Two layer output
      Named invalidation
      No trade conditions

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a candlestick chart screenshot into an annotated image showing channels, ranges, and key price levels.

USE CASE 2

Generate a trading plan overlay with entry triggers, invalidation points, and target zones based on a chart image.

USE CASE 3

Review past chart action with labeled evidence and outcomes instead of just naming a chart pattern.

What is it built with?

Python

How does it compare?

cheshiremew/price-action-analysisforsy-ai/forsy-trace-skillpetergpt/doomql
Stars545454
LanguagePythonPythonPython
Setup difficultyeasyeasyeasy
Complexity2/52/52/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires linking the repo folder into the Codex skills directory via a symlink or junction on Windows.

No license information was found in the README.

So what is it?

Price Action Analysis is a Codex skill that turns a candlestick chart screenshot or OHLC price data supplied by a user into an annotated trading chart. It draws channels, trading ranges, arrows, key price levels, pattern labels, and a trading plan directly on top of the chart image. The analysis follows a price action reading style associated with trader Al Brooks, looking at market context, market cycles, channels, trading ranges, breakouts, failed breakouts, and reversal attempts. The skill overlays deterministic annotations on the original chart rather than redrawing the candlesticks or making up price data. Each output combines two layers in the same image: a review of what already happened on the chart, and a current trading plan built from that context, including bullish and bearish trigger points, invalidation levels, target zones, and conditions under which no trade should be taken at all. The repository is meant to be linked into a Codex user skill folder using a symbolic link or directory junction on Windows, after which Codex can call it by name when a user provides a candlestick chart image. There is also a standalone rendering script that can draw the annotations onto an image file directly from a set of annotation data, without going through Codex. The project sets clear delivery standards for its output: every chart must include both the historical review layer and the current plan layer, the historical review must explain the evidence and plan that applied at the time rather than just naming a pattern, the current plan must state its trigger, stop or invalidation point, target zone, and no trade conditions, and any text on the chart must not cover important candles, the most recent price action, or the price axis. If real time or recent market data is used, its source and timing must be stated.

Copy-paste prompts

Prompt 1
Use price-action-analysis on this candlestick chart to generate an annotated image with channels, arrows, key price levels, and a trading plan.
Prompt 2
Explain how the price-action-analysis skill decides where to place invalidation levels and target zones on a chart.
Prompt 3
Walk me through linking the price-action-analysis repository into my Codex skills folder on Windows.
Prompt 4
Run the render_annotations.py script on this chart image and annotation JSON file to produce an output PNG.

Frequently asked questions

What is price-action-analysis?

A Codex skill that annotates candlestick chart screenshots with price action analysis, marking channels, key levels, and a trading plan directly on the image.

What language is price-action-analysis written in?

Mainly Python. The stack also includes Python.

What license does price-action-analysis use?

No license information was found in the README.

How hard is price-action-analysis to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is price-action-analysis for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.