傳說，西天王母生了二十三個女兒，其中最小的女兒名為叫瑤姬，她是二十三個里最美麗和最聰明的一個，因此深得父王母后及眾仙們的喜愛。
王母娘娘怕瑤姬在外受了委屈，便不準她外出游玩，要她留在西天瑤池中。
但生性活潑的瑤姬卻不甘寂寞，時常的偷偷出外游山玩水，唱歌跳舞，王母娘娘雖然多番教訓她，但瑤姬卻毫不理會，于是王母娘娘便決定把瑤姬送往紫清闕，交給三元仙君管教。
三元仙君見到瑤姬標致可人、且又聰穎過人，領悟性高，十分高興，于是將變化無窮的仙術全部教給了她。
瑤姬學成仙術，被王母娘娘封為云華上宮夫人，主管教導金童玉女的事情，并有一群侍女和六位侍臣伴在身旁。瑤姬不但把仙術全數授予金童玉女和眾侍臣，更經常與他們出外游玩。
一天，瑤姬帶領著金童玉女與眾侍女侍臣出外游玩，他們來到巫山上空，忽見巫山上天昏地暗，飛沙走石;巫山一帶房屋損毀，人畜著死傷無數。
瑤姬仔細一看，原來是巫山上十二條惡龍在興波作浪。瑤姬看見惡龍胡作非為，便輕身上了云頂，施放轟雷之術，把十二條惡龍打得筋骨碎裂，墜入山澗。
于是，巫山又回復平靜。但十二條惡龍的尸骨卻堵塞了長江里頭的水道，變成了三峽兩岸的崇山峻嶺，如此，江水匯積了三峽，引致水患頻生。
在人間的大禹聞訊趕來，指揮人們開道疏水，但山高石堅，水勢十分勐烈，治水方法毫不奏效，大禹苦無對策，只好坐在山上，看著滔滔洪水嘆息。瑤姬見狀，便派遣了六位侍臣下界來幫助大禹。
六位侍臣與大禹相見后，告明原因，和大禹提出對策，便施法召換來天兵天將，用雷去炸開山石，用電去推來泥沙，用火去燒掉海藻，而大禹則泒遺部屬去挖河床。終于，鑿成了三峽河道，使滯留的洪水得以消退。
大禹為了答謝瑤姬的恩德，為向她求教治水的方法，便來到巫山拜見瑤姬。
瑤姬看見大禹言辭恭謹，又充滿了拯救萬民于水患的熱誠，便取出了一本黃綾寶卷送給大禹，書中不但記載了疏渠鑿道的方法，更有驅使虎豹、制服蛟龍的秘訣，瑤姬又派遣了兩位侍臣助大禹治理洪水。
瑤姬在巫山逗留多時，正想繼續西去游玩，豈料王母娘娘駕到，要瑤姬回宮成就終身大事。
瑤姬不愿依從，立意留在人間為世人造福，她更化作了一座山峰，王母娘娘見勉強不來，只好獨自返回天庭。
而瑤姬所化成的山峰，被后人稱作神女峰，她的侍臣亦變成了巫山十二峰的其他諸峰，永遠守衛著瑤姬。
